Configuración de Nexus

Configure el gestor de repositorios Nexus para que guarde los artefactos de compilación en el repositorio de Nexus (repo).

Si configura la integración de esta herramienta al crear la cadena de herramientas, en la sección Integraciones configurables, pulse Nexus.
Si tienes una cadena de herramientas y vas a añadirle esta integración de herramientas, desde la consola ' IBM Cloud ', haz clic en el icono ' Menú ' ' > ' Automatización de plataformas > ' Cadenas de herramientas. En la página Cadenas de herramientas, pulse la cadena de herramientas para abrir su página Visión general. Como alternativa, en la página Visión general de su app, en la tarjeta de Entrega continua, pulse Ver cadena de herramientas. A continuación, pulse Visión general.

a. Pulse Añadir herramienta.

b. En la sección Integraciones de herramientas, pulse Nexus.
Escriba un nombre para esta instancia de la integración de herramientas Nexus.
Escriba el URL correspondiente al repositorio Nexus que desea abrir cuando pulse la tarjeta de Nexus en la cadena de herramientas.
Seleccione el tipo de repositorio con el que desea conectar.
Si ha seleccionado Registro de npm, siga estos pasos:

a. Escriba la dirección de correo electrónico asociada con el registro.

b. Escriba la señal de autenticación asociada con el registro.

c. Escriba el URL del repositorio de release de Nexus, que es el registro privado del servidor de Nexus.

d. Escriba el URL para el registro de duplicación o público que utiliza para combinar varios registros npm públicos y privados. Por ejemplo, este URL podría ser el URL del registro virtual en el servidor de Nexus que puede acceder tanto al registro privado como a la memoria caché del registro global de npm.
Si ha seleccionado Repositorio de Maven, siga estos pasos:

a. Escriba el ID de usuario asociado con el repositorio.

b. Escriba la contraseña asociada con el repositorio.

c. Escriba el URL del repositorio de release de Nexus, que es el repositorio del release privado del servidor de Nexus.

d. Escriba el URL del repositorio de instantáneas de Nexus, que es el repositorio de instantáneas privado del servidor de Nexus.

e. Escriba el URL del repositorio de duplicación o público que utilice para combinar varios repositorios Maven públicos y privados. Por ejemplo, este URL podría ser el URL del repositorio virtual en el servidor de Nexus que puede acceder tanto al repositorio privado como a la memoria caché del repositorio central de Maven.
Pulse Crear integración.
En la página Visión general de la cadena de herramientas, en la tarjeta Herramientas de terceros, pulse el repositorio de Nexus con el que desee trabajar. Se abrirá el sitio web de Nexus, donde puede ver el contenido del repositorio.
Opcional: si utiliza una cadena de herramientas en IBM Cloud Público y desea crear la app utilizando Nexus con npm, configure el conducto para añadir un trabajo de compilación de npm. Para obtener instrucciones sobre cómo configurar el trabajo de creación, consulte Configuración de un trabajo de compilación de npm de Nexus en el conducto.
Opcional: si utiliza una cadena de herramientas en IBM Cloud Público y desea crear la app utilizando Nexus con Maven, configure el conducto para añadir un trabajo de compilación de Maven. Para obtener instrucciones sobre cómo configurar el trabajo de creación, consulte Configuración de un trabajo de compilación de Maven de Nexus en el conducto.

Configuración de un trabajo de compilación de npm de Nexus en el conducto

Antes de configurar un trabajo de compilación de npm en el conducto, necesita un conducto en funcionamiento que pueda utilizar para crear el repositorio SCM como entrada y debe configurar Nexus para su cadena de herramientas. Para obtener instrucciones sobre cómo configurar Nexus, consulte la sección Nexus.

Configure Delivery Pipeline para añadir un trabajo de compilación de npm:

Cree una etapa y establezca la entrada al repositorio SCM adecuado.
En la etapa, añada un trabajo de trabajo de compilación.
Configure el trabajo de compilación:

build

a. Para el tipo de constructor, seleccione npm (Artifactory o Nexus).

b. Si ha configurado varias instancias de la integración de herramientas de Nexus, escriba el nombre de la integración de herramientas de Nexus para la que desea configurar el trabajo de compilación.

c. Para el tipo de integración de herramientas, seleccione Nexus.

d. Para el mandato de compilación, especifique los mandatos para crear el módulo npm o publicarlo en el registro. En este ejemplo se muestran los mandatos para crear el módulo o publicarlo.
```
npm install
# or
npm publish --registry "${NPM_RELEASE_URL}"
```
Encontrará el URL y las credenciales de usuario que ha utilizado para conectar con el registro en los valores de configuración correspondientes a la integración de herramientas de Nexus.

e. Si el trabajo de compilación se publica en el registro de Nexus y el formato de su versión del módulo de nodo es x.y.z-SNAPSHOT.w, marque el recuadro de selección Incrementar versión del módulo de instantáneas. El trabajo de compilación actualiza automáticamente la versión del módulo antes de que publique en el registro de Nexus. El trabajo de compilación selecciona la versión más alta del módulo a partir del registro de npm y el archivo package.json local e incrementa la versión del módulo utilizando semver. El trabajo de compilación no envía los cambios al repositorio SCM.
Pulse Guardar. Siempre que se ejecute el conducto, este trabajo de compilación utilizará la información de configuración de la integración de herramientas de Nexus para conectar con el registro de npm.

Configuración de un trabajo de compilación de Maven de Nexus en el conducto

Antes de configurar un trabajo de compilación de Maven en el conducto, necesita un conducto en funcionamiento que pueda utilizar para crear el repositorio SCM como entrada y debe configurar Nexus para su cadena de herramientas. Para obtener instrucciones sobre cómo configurar Nexus, consulte la sección Nexus.

Configure Delivery Pipeline para añadir un trabajo de compilación de Maven:

Cree una etapa y establezca la entrada al repositorio SCM adecuado.
En la etapa, añada un trabajo de trabajo de compilación.
Configure el trabajo de compilación:

build

a. Para el tipo de constructor, seleccione Maven (Artifactory, Nexus, SonarQube).

b. Si ha configurado varias instancias de la integración de herramientas de Nexus, escriba el nombre de la integración de herramientas de Nexus para la que desea configurar el trabajo de compilación de Maven.

c. Para el tipo de integración de herramientas, seleccione Nexus.

d. Para el mandato de compilación, escriba los mandatos para crear el módulo de Maven o publicarlo en el registro de instantáneas. En este ejemplo se muestran los mandatos para crear el módulo o publicarlo.
```
mvn -B clean package
# or
mvn -DaltDeploymentRepository="snapshots::default::${MAVEN_SNAPSHOT_URL}" deploy
```
Encontrará el URL y las credenciales de usuario que ha utilizado para conectar con el registro en los valores de configuración correspondientes a la integración de herramientas de Nexus.
Pulse Guardar. Siempre que se ejecute el conducto, este trabajo de compilación utilizará la información de configuración de la integración de herramientas de Nexus para conectar con el registro de Maven.

Configuración de Nexus mediante la API

La integración de herramientas Nexus da soporte a los siguientes parámetros de configuración que puede utilizar con la API HTTP de cadena de herramientas y SDK al crear, leery actualizar integraciones de herramientas.

Debe especificar la propiedad tool_type_id en el cuerpo de la solicitud con el valor nexus.

Parámetros de integración de la herramienta Nexus
Parámetro	Uso	Tipo	Argumento de Terraform	Descripción
dashboard_url	opcional, actualizable	Serie	url_servidor	El URL del panel de control del servidor Nexus para esta integración de herramientas. En la interfaz gráfica de usuario, el navegador va a este panel de control cuando pulsa la tarjeta de integración de la herramienta Nexus.
url_espejo	opcional, actualizable	Serie	url_espejo	El URL del repositorio virtual de Nexus donde puede ver los repositorios privados y una memoria caché de los repositorios públicos.
nombre	necesario, actualizable	Serie	nombre	El nombre de esta integración de herramientas.
url_release	opcional, actualizable	Serie	url_release	El URL del repositorio de release de Nexus.
url_instantánea	opcional, actualizable	Serie	url_instantánea	El URL del repositorio de instantáneas de Nexus.
señal	opcional, actualizable	Contraseña	señal	La contraseña o señal para autenticarse con el repositorio Nexus. Puede utilizar una referencia de secreto de cadena de herramientas para este parámetro. Para obtener más información sobre las referencias secretas, consulte Protección de los datos confidenciales en Continuous Delivery.
tipo	necesario, actualizable	Serie	tipo	El tipo de repositorio para la integración de herramientas de Nexus.
user_id	opcional, actualizable	Serie	user_id	El ID de usuario o la dirección de correo electrónico para autenticarse con el repositorio Nexus.