Configuration de Nexus

Configurez le gestionnaire de référentiels Nexus pour stocker les artefacts de génération dans votre référentiel Nexus.

Si vous configurez cette intégration d'outils lorsque vous créez la chaîne d'outils, à la section Intégrations configurables, cliquez sur Nexus.
Si vous avez une chaîne d'outils et que vous y ajoutez cette intégration d'outils, à partir de la console IBM Cloud, cliquez sur l' Menu > Automatisation de la plateforme > Chaînes d'outils. Sur la page Chaînes d'outils, cliquez sur la chaîne d'outils afin d'ouvrir sa page Vue d'ensemble. Vous pouvez également, depuis votre page de présentation de l'application, sur la carte Distribution continue, cliquer sur Afficher la chaîne d'outils. Ensuite, cliquez sur Vue d'ensemble.

a. Cliquez sur Ajouter un outil.

b. Dans la section Intégrations d'outils, cliquez sur Nexus.
Saisissez un nom pour cette instance de l'intégration d'outils Nexus.
Saisissez l'URL du référentiel Nexus qui doit s'ouvrir lorsque vous cliquez sur la carte Nexus à partir de votre chaîne d'outils.
Sélectionnez le type de référentiel auquel vous souhaitez vous connecter.
Si vous avez sélectionné Registre npm, procédez comme suit :

a. Saisissez l'adresse électronique associée à votre registre.

b. Saisissez le jeton d'authentification associé à votre registre.

c. Saisissez l'URL de votre référentiel d'édition Nexus, qui est votre registre privé sur le serveur Nexus.

d. Saisissez l'URL du registre miroir ou public que vous utilisez pour combiner plusieurs registres npm publics et privés. Par exemple, cette URL peut être l'adresse du registre virtuel sur votre serveur Nexus, qui peut accéder à la fois à votre registre privé et à un cache du registre npm global.
Si vous avez sélectionné Référentiel Maven, procédez comme suit :

a. Saisissez l'ID utilisateur associé à votre référentiel.

b. Saisissez le mot de passe associé à votre référentiel.

c. Saisissez l'URL de votre référentiel d'édition Nexus, qui est votre référentiel d'édition privé sur le serveur Nexus.

d. Saisissez l'URL de votre référentiel d'image instantanée Nexus, qui est votre référentiel d'image instantanée privé sur le serveur Nexus.

e. Saisissez l'URL du référentiel miroir ou public que vous utilisez pour combiner plusieurs référentiels Maven publics et privés. Par exemple, cette URL peut être l'adresse du référentiel virtuel sur votre serveur Nexus, qui peut accéder à la fois à vos référentiels privés et à un cache du référentiel Maven central.
Cliquez sur Créer une intégration.
À partir de la page Présentation de la chaîne d'outils, sur la carte Outils tiers, cliquez sur le programme du référentiel Nexus avec lequel vous souhaitez travailler. Le site Web Nexus s'ouvre ; vous pouvez y afficher le contenu du référentiel.
Facultatif : Si vous utilisez une chaîne d'outils sur IBM Cloud Public et que vous voulez générez votre application à l'aide de Nexus avec npm, configurez votre pipeline pour ajouter un travail de génération npm. Pour des instructions de configuration du travail de génération, voir la section Configuration d'un travail de génération npm Nexus sur votre pipeline.
Facultatif : Si vous utilisez une chaîne d'outils sur IBM Cloud Public et que vous voulez générer votre application à l'aide de Nexus avec Maven, configurez votre pipeline pour ajouter un travail de génération Maven. Pour des instructions de configuration du travail de génération, voir la section Configuration d'un travail de génération Maven Nexus sur votre pipeline.

Configuration d'un travail de génération npm Nexus sur votre pipeline

Avant de configurer un travail de génération npm sur votre pipeline, vous devez disposer d'un pipeline opérationnel qui peut utiliser votre référentiel SCM de génération en entrée et vous devez configurer Nexus pour votre chaîne d'outils. Pour les instructions de configuration de Nexus, voir la section Nexus.

Configurez Delivery Pipeline pour ajouter un travail de génération npm :

Créez une étape et définissez l'entrée sur le référentiel SCM approprié.
Dans l'étape, ajoutez un travail de génération.
Configurez le travail de génération :

build

a. Pour le type de générateur, sélectionnez npm (Artifactory ou Nexus).

b. Si vous avez configuré plusieurs instances de l'intégration d'outils Nexus, saisissez le nom de l'intégration d'outils Nexus pour laquelle vous souhaitez configurer le travail de génération npm.

c. Pour le type d'intégration d'outils, sélectionnez Nexus.

d. Pour la commande de génération, saisissez les commandes permettant de générer votre module npm ou de le publier dans votre registre. Cet exemple montre les commandes de génération ou de publication du module.
```
npm install
# or
npm publish --registry "${NPM_RELEASE_URL}"
```
Vous pouvez trouver l'URL et les données d'identification de l'utilisateur dont vous vous êtes servi pour vous connecter à votre registre dans les paramètres de configuration pour l'intégration des outils Nexus.

e. Si votre travail de génération est publié dans le registre Nexus et si le format de votre version de module de noeud est x.y.z-SNAPSHOT.w, cochez la case Incrémenter la version du module d'instantané. Le travail de génération met automatiquement à jour la version du module avant qu'il ne soit publié dans le registre Nexus. Le travail de génération sélectionne la version la plus élevée du module à partir du registre npm et du fichier local package.json, et incrémente la version du module à l'aide de semver. Le travail de génération ne répercute pas les modifications dans le référentiel SCM.
Cliquez sur Enregistrer. Lors de l'exécution de votre pipeline, ce travail de génération utilise les informations de configuration provenant de l'intégration d'outils Nexus pour la connexion à votre registre npm.

Configuration d'un travail de génération Maven Nexus sur votre pipeline

Avant de configurer un travail de génération Maven sur votre pipeline, vous devez disposer d'un pipeline opérationnel qui peut utiliser votre référentiel SCM de génération en entrée et vous devez configurer Nexus pour votre chaîne d'outils. Pour les instructions de configuration de Nexus, voir la section Nexus.

Configurez Delivery Pipeline pour ajouter un travail de génération Maven :

Créez une étape et définissez l'entrée sur le référentiel SCM approprié.
Dans l'étape, ajoutez un travail de génération.
Configurez le travail de génération :

caption-side=bottom"

construction de Maven*

a. Pour le type de générateur, sélectionnez Maven (Artifactory, Nexus, SonarQube).

b. Si vous avez configuré plusieurs instances de l'intégration d'outils Nexus, saisissez le nom de l'intégration d'outils Nexus pour laquelle vous souhaitez configurer le travail de génération Maven.

c. Pour le type d'intégration d'outils, sélectionnez Nexus.

d. Pour la commande de génération, saisissez les commandes permettant de générer votre module Maven ou de le publier dans votre registre d'image instantanée. Cet exemple montre les commandes de génération ou de publication du module.
```
mvn -B clean package
# or
mvn -DaltDeploymentRepository="snapshots::default::${MAVEN_SNAPSHOT_URL}" deploy
```
Vous pouvez trouver l'URL et les données d'identification de l'utilisateur dont vous vous êtes servi pour vous connecter à votre registre dans les paramètres de configuration pour l'intégration des outils Nexus.
Cliquez sur Enregistrer. Lors de l'exécution de votre pipeline, ce travail de génération utilise les informations de configuration provenant de l'intégration d'outils Nexus pour la connexion à votre référentiel Maven.

Configuration de Nexus à l'aide de l'API

L'intégration d'outils Nexus prend en charge les paramètres de configuration suivants que vous pouvez utiliser avec l'API HTTP de chaîne d'outils et les logiciels SDK lorsque vous créez, lisezet mettez à jour les intégrations d'outils.

Vous devez spécifier la propriété tool_type_id dans le corps de la demande avec la valeur nexus.

Paramètres d'intégration de l'outil Nexus
Paramètre	Utilisation	Type	Argument Terraform	Description
dashboard_url	facultatif, pouvant être mis à jour	Chaîne	url_serveur	URL du tableau de bord du serveur Nexus pour cette intégration d'outils. Dans l'interface graphique, le navigateur accède à ce tableau de bord lorsque vous cliquez sur la carte d'intégration d'outils Nexus.
url_miroir	facultatif, pouvant être mis à jour	Chaîne	url_miroir	URL de votre référentiel virtuel Nexus où vous pouvez afficher vos référentiels privés et un cache des référentiels publics.
nom	requis, pouvant être mis à jour	Chaîne	nom	Nom de cette intégration d'outils.
url_édition	facultatif, pouvant être mis à jour	Chaîne	url_édition	URL de votre référentiel d'édition Nexus.
url_image_instantanée	facultatif, pouvant être mis à jour	Chaîne	url_image_instantanée	URL de votre référentiel d'instantanés Nexus.
jeton	facultatif, pouvant être mis à jour	Mot de passe	jeton	Mot de passe ou jeton pour l'authentification avec le référentiel Nexus. Vous pouvez utiliser une référence de secret de chaîne d'outils pour ce paramètre. Pour plus d'informations sur les références secrètes, voir Protection de vos données sensibles dans Continuous Delivery.
type	requis, pouvant être mis à jour	Chaîne	type	Type de référentiel pour votre intégration d'outils Nexus.
user_id	facultatif, pouvant être mis à jour	Chaîne	user_id	ID utilisateur ou adresse électronique pour l'authentification auprès de votre référentiel Nexus.