Configurazione di Nexus

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

Se stai configurando questa integrazione dello strumento mentre crei la toolchain, nella sezione Integrazioni configurabili, fai clic su Nexus.
Se si dispone di una catena di strumenti e vi si aggiunge l'integrazione di questo strumento, dalla console IBM Cloud, fare clic sull'icona Menu Automazione piattaforma > Catene di strumenti. Nella pagina Toolchains, fai clic sulla toolchain per aprirne la pagina di panoramica. In alternativa, nella pagina della panoramica della tua applicazione, nella scheda di fornitura continua, fai clic su View toolchain. Fai quindi clic su Overview.

a. Fai clic su Add tool.

b. Nella sezione Integrazioni strumento, fai clic su Nexus.
Immetti un nome per questa istanza dell'integrazione dello strumento Nexus.
Immetti l'URL per il repository Nexus che desideri aprire quando fai clic sulla scheda Nexus dalla tua toolchain.
Seleziona il tipo di repository a cui vuoi collegarti.
Se hai selezionato npm registry, 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 Nexus, che corrisponde al tuo registro privato nel server Nexus.

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 Nexus che può accedere al tuo registro privato e a una cache del registro globale npm.
Se hai selezionato Maven repository, 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 Nexus, che corrisponde al tuo repository della release privato nel server Nexus.

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

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 Nexus che può accedere ai tuoi repository privati e a una cache del repository centrale Maven.
Fai clic su Crea integrazione.
Dalla pagina Panoramica della tua toolchain, nella scheda Strumenti di terze parti, fai clic sul repository Nexus con cui vuoi lavorare. Si apre il sito web Nexus, dove puoi visualizzare i contenuti del repository.
Facoltativo: se stai utilizzando una toolchain in IBM Cloud Pubblico e desideri creare la tua applicazione utilizzando Nexus 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 Nexus nella tua pipeline.
Facoltativo: se stai utilizzando una toolchain in IBM Cloud Pubblico e desideri creare la tua applicazione utilizzando Nexus 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 Nexus Maven nella tua pipeline.

Configurazione di un lavoro di build npm Nexus nella tua pipeline

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

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 (Artifactory or Nexus).

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

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

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 Nexus.

e. Se il tuo lavoro di build viene pubblicato nel registro Nexus, 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 venga pubblicato nel registro Nexus. Il lavoro di build 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 Nexus per collegarsi al tuo registro npm.

Configurazione di un lavoro di build Maven Nexus 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 Nexus per la tua toolchain. Per istruzioni sulla configurazione di Nexus, vedi la sezione Nexus.

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 (Artifactory, Nexus, SonarQube).

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

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

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.
```
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 Nexus.
Fare clic su Salva. Se la tua pipeline è in esecuzione, questo lavoro di build utilizza le informazioni sulla configurazione dall'integrazione dello strumento Nexus per collegarsi al tuo repository Maven.

Configurazione di Nexus utilizzando l'API

L'integrazione dello strumento Nexus supporta i seguenti parametri di configurazione che puoi utilizzare con le integrazioni dello strumento Toolchain HTTP API e SDK quando crei, leggie aggiorna.

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

Parametri di integrazione dello strumento Nexus
Parametro	Utilizzo	Immettere	Argomento Terraform	Descrizione
dashboard_url	facoltativo, aggiornabile	Stringa	url server	L'URL del dashboard del server Nexus per questa integrazione dello strumento. Nell'interfaccia utente grafica, il browser passa a questo dashboard quando si fa clic sulla scheda di integrazione dello strumento Nexus.
url_mirror	facoltativo, aggiornabile	Stringa	url_mirror	L'URL del tuo repository virtuale Nexus 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	L'URL del tuo repository della release Nexus.
url_istantanea	facoltativo, aggiornabile	Stringa	url_istantanea	L'URL del tuo repository di istantanee Nexus.
token	facoltativo, aggiornabile	Password	token	La password o il token per l'autenticazione con il repository Nexus. Puoi utilizzare un riferimento segreto della toolchain per questo parametro. Per ulteriori informazioni sui riferimenti segreti, vedi Protezione dei tuoi dati sensibili in Continuous Delivery.
Immettere	richiesto, aggiornabile	Stringa	Immettere	Il tipo di repository per l'integrazione dello strumento Nexus.
user_id	facoltativo, aggiornabile	Stringa	user_id	L'ID utente o l'indirizzo email per l'autenticazione con il tuo repository Nexus.