Configura il tuo Artifactory

Configurazione del tuo repository Artifactory per collegarti al repository di artefatti Agora di Deque

Segui questi passaggi quando vuoi connetterti al repository di artefatti Agora di Deque dalla tua istanza di Artifactory. Configurare questo repository remoto autenticato all'interno di Artifactory consente ai tuoi utenti di accedere ai componenti di Axe DevTools attraverso la tua rete di distribuzione software.

Prerequisiti

È necessario disporre delle credenziali di accesso di Agora e delle credenziali di amministratore per l'istanza Artifactory per configurare questa connessione al repository. Deque consiglia di utilizzare un account di servizio Agora per tali credenziali piuttosto che un account personale.

Utilizzare un Account di Servizio

Deque raccomanda di autenticare questa connessione con un account di servizio di Agora piuttosto che con il tuo account personale di Agora. Un account di servizio è un account di Agora che appartiene al tuo team piuttosto che a un singolo membro del team.

Il tuo gestore del repository — il server che ospita il repository remoto che stai configurando — memorizza le credenziali dell'account di servizio e le utilizza quando necessario per raggiungere Agora. Non scarica i pacchetti in anticipo. La prima volta che uno dei tuoi sviluppatori o pipeline di build installa un pacchetto Axe DevTools, il repository remoto recupera quel pacchetto da Agora e ne conserva una copia, e le installazioni successive vengono servite dalla copia. I tuoi sviluppatori e i sistemi automatizzati richiedono pacchetti solo al gestore del tuo repository, quindi non hanno mai bisogno dei propri account di Agora.

Una connessione basata sull'accesso di una singola persona dipende dal mantenimento dell'accesso ad Agora da parte di quella persona. Se lasciano la tua organizzazione, nessuno può accedere al loro account per ricreare il Token di Identità quando scade, e le installazioni falliscono per tutti. Un account di servizio non dipende da una sola persona.

Gestire l'Account di Servizio

Tratta il Token di Identità dell'account di servizio — la credenziale simile a una password emessa da Agora per l'account — come una credenziale di infrastruttura condivisa e gestiscila seguendo le politiche di sicurezza e di gestione delle credenziali della tua organizzazione. Archiviala in un gestore di segreti o nell'archiviazione dei segreti del tuo provider CI e fanne riferimento dalla configurazione del tuo gestore del repository, piuttosto che impegnarla nel controllo del codice sorgente. Chiedi a Deque di limitare l'account di servizio solo all'accesso in lettura necessario quando lo richiedi, e chiedici di revocare e riemettere il token se potrebbe essere stato esposto o quando cambia il proprietario dell'account.

Assegna un proprietario all'account all'interno della tua organizzazione. I Token di Identità scadono (di solito dopo un anno), quindi il proprietario dell'account deve ricreare il token prima che scada. Chiunque lo ricrei deve anche aggiornare il token memorizzato che il tuo gestore del repository utilizza per connettersi ad Agora, perché il gestore del tuo repository non può scaricare nuovi pacchetti e aggiornamenti fino a quando il token memorizzato non viene aggiornato.

Creazione di un token d'identità di Agora

Per iniziare, accedi ad Agora come account di servizio, in modo che il Token di Identità appartenga all'account di servizio piuttosto che a un account personale. Se non utilizzi un account di servizio, accedi con le tue credenziali personali. Fai clic sul pulsante Benvenuto nell'angolo in alto a destra per aprire la pagina del profilo. Genera lì un Token di Identità e copialo.

Connessione ad Agora

1. Accedi al tuo Artifactory Repository Manager con le tue credenziali di amministratore.
2. Seleziona Admin nel menu di navigazione a sinistra.
3. Seleziona „Remote“ sotto „Repositories“ per visualizzare la pagina dei repository remoti.
4. Seleziona „Create New“ in alto a destra nella pagina dei Remote Repositories.
5. La pagina dovrebbe visualizzare un elenco di tipi di pacchetti
6. Seleziona il tuo tipo di pacchetto (ad es. npm)
7. La pagina di creazione del repository dovrebbe mostrare un modulo (vedi sopra l'esempio di un repository npm).
   1. Nel campo Repository Key, digita il nome che desideri utilizzare per fare riferimento al repository. La chiave del repository non deve contenere spazi o caratteri speciali, deve essere unica, non deve iniziare con un numero ed è limitata a 58 caratteri.
   2. Inserisci l'URL al registro Agora (vedi URL del Registro Agora sotto).
   3. Seleziona i layout appropriati (i predefiniti dovrebbero funzionare per ogni tipo di repository)
8. Clicca sul pulsante „Test“ per testare la connessione
9. Clicca „Save and Finish“
10. Se vuoi che gli utenti utilizzino questo repository di default, dovrai includerlo in uno qualsiasi dei tuoi registri virtuali

URL del Registro Agora

• npm: https://agora.dequecloud.com/artifactory/api/npm/devtools-npm/
• Maven: https://agora.dequecloud.com/artifactory/devtools-maven/
• NuGet: https://agora.dequecloud.com/artifactory/api/nuget/devtools-nuget/
• Gems: https://agora.dequecloud.com/artifactory/devtools-gems/
• Pip: https://agora.dequecloud.com/artifactory/api/pypi/devtools-python/simple/