Configuration d'Artifactory

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

Si vous configurez cette intégration d'outils lorsque vous créez la chaîne d'outils, à la section Intégrations configurables, cliquez sur Artifactory.
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 une 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 Artifactory.
Saisissez l'URL du référentiel Artifactory qui doit s'ouvrir lorsque vous cliquez sur la carte Artifactory.
Sélectionnez le type de référentiel auquel vous souhaitez vous connecter.
Si vous utilisez un registre npm Artifactory, 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 Artifactory, qui est votre registre privé sur le serveur Artifactory.

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 Artifactory, qui peut accéder à la fois à votre registre privé et à un cache du registre npm global.
Si vous utilisez un référentiel Maven Artifactory, 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 Artifactory, qui est votre référentiel d'édition privé sur le serveur Artifactory.

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

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 Artifactory, 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.
Sur la carte Outils tiers, cliquez sur l'intégration de l'outil Artifactory pour le référentiel Artifactory avec lequel vous souhaitez travailler. Le site Web Artifactory 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 d'Artifactory 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 Artifactory 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 d'Artifactory 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 Artifactory sur votre pipeline.

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

Avant de configurer un travail de génération npm dans 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. Vous devez également configurer Artifactory pour votre chaîne d'outils. Pour les instructions de configuration d'Artifactory, voir la section Artifactory.

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

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

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

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

e. Si votre travail de génération est publié dans le registre Artifactory 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 que le travail ne soit publié dans le registre Artifactory. Le travail 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 pour la connexion à votre registre npm.

Configuration d'un travail de génération Maven Artifactory 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 Artifactory pour votre chaîne d'outils. Pour les instructions de configuration d'Artifactory, voir la section Artifactory.

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

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

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

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 permettant de générer le module ou de le publier dans un registre d'image instantanée.
```
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 Artifactory.
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 pour la connexion à votre référentiel Maven.

Configurer Artifactory en utilisant l'API

L'intégration d'outils Artifactory 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 artifactory.

Paramètres d'intégration des outilsArtifactory
Paramètre	Utilisation	Type	Argument Terraform	Description
dashboard_url	facultatif, pouvant être mis à jour	Chaîne	dashboard_url	URL du tableau de bord du serveur Artifactory 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 Artifactory.
url_miroir	facultatif, pouvant être mis à jour	Chaîne	url_miroir	URL de votre référentiel virtuel Artifactory 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 Artifactory.
nom_référentiel	facultatif, pouvant être mis à jour	Chaîne	nom_référentiel	Nom de votre référentiel Artifactory dans lequel se trouvent vos images Docker.
url_référentiel	facultatif, pouvant être mis à jour	Chaîne	url_référentiel	URL de votre référentiel Artifactory dans lequel se trouvent vos images Docker.
url_image_instantanée	facultatif, pouvant être mis à jour	Chaîne	url_image_instantanée	URL de votre référentiel d'instantanés Artifactory.
jeton	facultatif, pouvant être mis à jour	Mot de passe	jeton	Jeton d'accès de votre référentiel Artifactory. 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 de secret de chaîne d'outils, 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 Artifactory.
user_id	facultatif, pouvant être mis à jour	Chaîne	user_id	ID utilisateur ou adresse électronique de votre référentiel Artifactory.