Configurazione di Artifactory

DevOps Insights Il servizio giungerà al termine e verrà interrotto il 31 agosto 2026. Il servizio " Continuous Delivery " verrà interrotto nelle seguenti regioni il 12 febbraio 2027: au-syd, ca-tor, us-east. A partire da tale data, anche Code Risk Analyzer verrà ritirato dal mercato in tutte le regioni. Se in una regione non si riscontra un utilizzo attivo di queste funzionalità, queste potrebbero essere dismesse anticipatamente e non accettare più nuove istanze. Per saperne di più

Configura il gestore del repository Artifactory per archiviare le risorse di build nel tuo repository (repo) Artifactory.

Se stai configurando questa integrazione dello strumento mentre crei la toolchain, nella sezione Integrazioni configurabili, fai clic su Artifactory.
Se disponi già di una toolchain e desideri integrarvi questo strumento, dalla console IBM Cloud, fai clic sull'icona del menu ( ) > Automazione della piattaforma > Toolchain. Nella pagina Toolchains, fai clic su una toolchain per aprirne la pagina di panoramica.

a. Fai clic su Add tool.

b. Nella sezione Integrazioni strumento, fai clic su Artifactory.
Immetti l'URL per il repository Artifactory che desideri aprire quando fai clic sulla scheda Artifactory.
Seleziona il tipo di repository a cui vuoi collegarti.
Se stai utilizzando un registro npm Artifactory, completa la seguente procedura:

a. Immetti l'indirizzo email associato al tuo registro.

b. Immetti il token di autenticazione associato al tuo registro.

c. Immetti l'URL per il tuo repository della release Artifactory, che corrisponde al tuo registro privato nel server Artifactory.

d. Immetti l'URL per il registro Mirror o Public che utilizzi per combinare più registri npm privati e pubblici. Ad esempio, questo URL potrebbe essere l'URL del registro virtuale nel tuo server Artifactory che può accedere al tuo registro privato e a una cache del registro globale npm.
Se stai utilizzando un repository Artifactory Maven, completa la seguente procedura:

a. Immetti l'ID utente associato al tuo repository.

b. Immetti la password associata al tuo repository.

c. Immetti l'URL per il tuo repository della release Artifactory, che corrisponde al tuo repository della release privato sul server Artifactory.

d. Immetti l'URL del tuo repository delle istantanee Artifactory, che corrisponde al tuo repository delle istantanee privato sul server Artifactory.

e. Immetti l'URL per il repository Mirror o Public che utilizzi per combinare più repository Maven privati e pubblici. Ad esempio, questo URL potrebbe essere l'URL del repository virtuale nel tuo server Artifactory che può accedere ai tuoi repository privati e a una cache del repository centrale Maven.
Fai clic su Crea integrazione.
Nella scheda Strumenti di terze parti, fai clic sull'integrazione dello strumento Artifactory per il repository Artifactory con cui vuoi lavorare. Si apre il sito web Artifactory, dove puoi visualizzare i contenuti del repository.
Facoltativo: se stai utilizzando una toolchain in IBM Cloud Pubblico e desideri creare la tua applicazione utilizzando Artifactory con npm, configura la tua pipeline per aggiungere un lavoro di build npm. Per istruzioni sulla configurazione del lavoro di build, consulta la sezione Configurazione di un lavoro di build npm Artifactory nella tua pipeline.
Facoltativo: se stai utilizzando una toolchain in IBM Cloud Pubblico e desideri creare la tua applicazione utilizzando Artifactory con Maven, configura la tua pipeline per aggiungere un lavoro di build Maven. Per istruzioni sulla configurazione del lavoro di build, consulta la sezione Configurazione di un lavoro di build Artifactory Maven nella tua pipeline.

Configurazione di un lavoro di build npm Artifactory nella tua pipeline

Prima di configurare un lavoro di build npm nella tua pipeline, devi disporre di una pipeline funzionante che utilizzi il tuo repository SCM di build come input. Devi configurare anche Artifactory per la tua toolchain. Per istruzioni sulla configurazione di Artifactory, vedi la sezione Artifactory.

Configura Delivery Pipeline per aggiungere un lavoro di build npm:

Crea una fase e configura l'input per il repository SCM appropriato.
Nella fase, aggiungi un lavoro di build.
Configurare il lavoro di generazione:

build

a. Per il tipo di builder, seleziona NPM Build.

b. Se hai configurato più istanze dell'integrazione dello strumento Artifactory, immetti il nome dell'integrazione dello strumento Artifactory per cui desideri configurare il lavoro di build npm.

c. Per il tipo di integrazione dello strumento, seleziona Artifactory.

d. Per il comando di build, immetti i comandi per creare il tuo modulo npm o pubblicalo nel tuo registro. Questo esempio mostra i comandi per creare il modulo o per pubblicarlo.
```
npm install
# or
npm publish --registry "${NPM_RELEASE_URL}"
```
Puoi trovare l'URL e le credenziali utente che hai utilizzato per collegarti al tuo registro nelle impostazioni di configurazione per l'integrazione dello strumento Artifactory.

e. Se il tuo lavoro di build viene pubblicato nel registro Artifactory, e il formato della versione del modulo del tuo nodo è x.y.z-SNAPSHOT.w, seleziona la casella di spunta Increment snapshot module version. Il lavoro di build aggiorna automaticamente la versione del modulo prima che il lavoro venga pubblicato nel registro Artifactory. Il lavoro seleziona l'ultima versione del modulo dal registro npm e il file package.json locale e incrementa la versione del modulo utilizzando semver. Il lavoro di build non fornisce le modifiche al repository SCM.
Fare clic su Salva. Se la tua pipeline è in esecuzione, questo lavoro di build utilizza le informazioni sulla configurazione dall'integrazione dello strumento Artifactory per collegarsi al tuo registro npm.

Configurazione di un lavoro di build Artifactory Maven nella tua pipeline

Prima di configurare un lavoro di build Maven nella tua pipeline, devi disporre di una pipeline funzionante che utilizzi per creare il repository SCM come input e devi configurare Artifactory per la tua toolchain. Per istruzioni sulla configurazione di Artifactory, vedi la sezione Artifactory.

Configura la Delivery Pipeline per aggiungere un lavoro di build Maven:

Crea una fase e configura l'input per il repository SCM appropriato.
Nella fase, aggiungi un lavoro di build.
Configurare il lavoro di generazione:

di compilazione di Maven* Lavoro di compilazione di

a. Per il tipo di builder, seleziona Maven Build.

b. Se hai configurato più istanze dell'integrazione dello strumento Artifactory, immetti il nome dell'integrazione dello strumento Artifactory per cui desideri configurare il lavoro di build Maven.

c. Per il tipo di integrazione dello strumento, seleziona Artifactory.

d. Per il comando di build, immetti i comandi per creare il tuo modulo Maven o pubblicalo nel tuo registro delle istantanee. Questo esempio mostra i comandi per creare il modulo o per pubblicarlo in un registro delle istantanee.
```
mvn -B clean package
# or
mvn -DaltDeploymentRepository="snapshots::default::${MAVEN_SNAPSHOT_URL}" deploy
```
Puoi trovare l'URL e le credenziali utente che hai utilizzato per collegarti al tuo registro nelle impostazioni di configurazione per l'integrazione dello strumento Artifactory.
Fare clic su Salva. Se la tua pipeline è in esecuzione, questo lavoro di build utilizza le informazioni sulla configurazione dall'integrazione dello strumento Artifactory per collegarsi al tuo repository Maven.

Configurazione di Artifactory utilizzando l'API

L'integrazione Artifactory degli strumenti supporta i seguenti parametri di configurazione che è possibile utilizzare con l 'API HTTP Toolchain e gli SDK durante la creazione, la lettura e l'aggiornamento delle integrazioni degli strumenti.

È necessario specificare la proprietà tool_type_id nel corpo della richiesta con il valore artifactory.

Parametri di integrazione dello strumentoArtifactory
Parametro	Utilizzo	Immettere	Argomento Terraform	Descrizione
dashboard_url	facoltativo, aggiornabile	Stringa	dashboard_url	Il URL del pannello di controllo Artifactory del server per l'integrazione di questo strumento. Nell'interfaccia utente grafica, il browser accede a questa dashboard quando si fa clic sulla scheda di integrazione Artifactory dello strumento.
url_mirror	facoltativo, aggiornabile	Stringa	url_mirror	Il URL del tuo Artifactory repository virtuale dove puoi visualizzare i tuoi repository privati e una cache dei repository pubblici.
nome	richiesto, aggiornabile	Stringa	nome	Il nome di questa integrazione dello strumento.
url release_url	facoltativo, aggiornabile	Stringa	url release_url	Il URL del tuo Artifactory repository di rilascio.
nome_repository	facoltativo, aggiornabile	Stringa	nome_repository	Il nome del tuo repository Artifactory in cui si trovano le tue immagini Docker.
url_repository	facoltativo, aggiornabile	Stringa	url_repository	Il URL del tuo Artifactory repository in cui si trovano le tue Docker immagini.
url_istantanea	facoltativo, aggiornabile	Stringa	url_istantanea	Il URL del tuo Artifactory repository snapshot.
token	facoltativo, aggiornabile	Password	token	Il token di accesso per il tuo repository Artifactory. Puoi utilizzare un riferimento segreto della toolchain per questo parametro. Per ulteriori informazioni sui riferimenti segreti della toolchain, vedi Protezione dei tuoi dati sensibili in Continuous Delivery.
Immettere	richiesto, aggiornabile	Stringa	Immettere	Il tipo di repository per l'integrazione dello strumento Artifactory.
user_id	facoltativo, aggiornabile	Stringa	user_id	L'ID utente o l'indirizzo email per il tuo repository Artifactory.