Configuration de Delivery Pipeline

Delivery Pipeline automatise le déploiement continu de vos projets via des séquences d'étapes qui extraient des travaux en entrée et d'exécution tels que des générations, des tests et des déploiements.

Configurez Delivery Pipeline afin d'automatiser la génération, le test et le déploiement en continu de vos applications.

Si vous configurez cette intégration d'outils lorsque vous créez la chaîne d'outils, à la section Intégrations configurables, cliquez sur Delivery Pipeline. En fonction du modèle utilisé, des zones différentes peuvent être disponibles. Passez en revue les valeurs de zone par défaut et, si nécessaire, modifiez ces paramètres.
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 à laquelle vous souhaitez ajouter Delivery Pipeline. 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 Delivery Pipeline.
Indiquez un nom pour votre nouveau pipeline.
Sélectionnez le type de pipeline à créer.
- Classique: Fournit une interface graphique facile à utiliser pour définir les étapes et les travaux qui s'exécutent sur une infrastructure publique partagée, avec la possibilité d'exécuter des étapes individuelles sur des travailleurs privés.
- Tekton : fournit un tableau de bord que vous pouvez utiliser pour afficher la sortie des exécutions de pipeline Tekton sur un cluster Kubernetes défini, avec prise en charge de la configuration des référentiels de définitions de pipeline, des déclencheurs de pipeline, de l'emplacement où le pipeline s'exécute et des valeurs confidentielles simples.
Si vous prévoyez d'utiliser votre pipeline pour déployer une interface utilisateur et qu'il s'agit d'un pipeline classique, cochez la case Afficher les applications dans le menu Voir l'application. Toutes les applications créées par votre pipeline sont affichées dans la liste Afficher l'application de la page Présentation de la chaîne d'outils.
Cliquez sur Créer une intégration pour ajouter Delivery Pipeline à votre chaîne d'outils.
Dans votre chaîne d'outils, sur la carte Pipelines de livraison, cliquez sur le pipeline de livraison pour l'afficher et le configurer. Pour en savoir plus sur les notions de base et la configuration d'un pipeline, voir Génération et déploiement de pipelines.

Si vous souhaitez que le pipeline s'exécute automatiquement lorsqu'une validation est envoyée à votre référentiel GitHub ou Git, procédez comme suit :

a. Configurez GitHub ou Git Repos and Issue Tracking pour votre chaîne d'outils avant de définir les étapes pour votre pipeline. Ces étapes requièrent les URL de vos référentiels. Chaque étape de pipeline peut faire référence à un seul des référentiels GitHub ou Git associés à votre chaîne d'outils. Pour savoir comment configurer GitHub, voir la section GitHub. Pour les instructions de configuration de Git Repos and Issue Tracking, voir la section Git Repos and Issue Tracking.

b. Utilisez un webhook. Sans webhook, vous pouvez seulement exécuter les pipelines manuellement. Pour utiliser un webhook lorsque vous vous connectez à un référentiel GitHub ou GitHub Enterprise, vous devez disposer d'un droit d'administrateur. Pour associer un référentiel Git Repos and Issue Tracking, vous devez disposer d'un droit Maître ou Propriétaire.
Facultatif : si vous utilisez une chaîne d'outils sur IBM Cloud public et souhaitez que Sauce Labs exécute des tests sur votre application, configurez Delivery Pipeline pour ajouter un travail de test Sauce Labs. Pour des instructions de configuration du travail de test, voir la section Configuration d'un travail de test Sauce Labs sur votre pipeline.

Configuration d'un travail de test Sauce Labs sur votre pipeline

Avant de configurer un travail de test Sauce Labs sur votre pipeline, vous avez besoin d'un pipeline opérationnel qui comporte des étapes pour la génération et le déploiement de votre application. Vous devez également configurer Sauce Labs pour votre chaîne d'outils. Pour des instructions sur la configuration de Sauce Labs, voir la section Sauce Labs.

Configurez Delivery Pipeline pour ajouter un travail de test Sauce Labs.

Si vous n'avez pas d'étape pour le déploiement d'une version de test de votre application, créez-en une.
Dans l'étape, ajoutez un travail de test après le travail de déploiement. Le fait de placer ces travaux dans la même étape leur permet d'accéder au même ensemble de propriétés d'environnement.

de test*Travail de
Configurez l'étape. Sur l'onglet PROPRIETES D'ENVIRONNEMENT, créez la propriété CF_APP_NAME.

Le nom d'utilisateur et la clé d'accès de Sauce Labs sont disponibles dans le script de la tâche de test en tant que variables d'environnement SAUCE_USERNAME et SAUCE_ACCESS_KEY. Lorsque vous rédigez vos tests, vous devez utiliser ces variables d'environnement pour vous authentifier auprès de Sauce Labs.
Configurez le travail de déploiement. Dans la zone Script de déploiement, ajoutez la commande suivante : export CF_APP_NAME="$CF_APP". Cette commande exporte le nom d'application en tant que propriété d'environnement.
Configurez le travail de test.

Les champs Instance de service, Cible, Organisation et Espace sont remplis avec le nom d'utilisateur, la région, l'organisation et l'espace Sauce Labs que vous utilisez.

a. Pour le type d'outil de test, sélectionnez Sauce Labs.

b. Pour l'instance de service, sélectionnez le nom d'utilisateur Sauce Labs que vous avez utilisé lorsque vous avez configuré Sauce Labs pour votre chaîne d'outils.

Pour voir le nom d'utilisateur et la clé d'accès que vous avez utilisés lorsque vous avez configuré Sauce Labs pour votre chaîne d'outils, cliquez sur Configurer.

c. Dans la zone Commande d'exécution de test, entrez les commandes d'installation des dépendances qui sont requises par vos tests, puis exécutez les tests. Par exemple, pour une application Node.js, vous pourriez entrer les commandes suivantes :
```
npm install
node_modules/grunt-cli/bin/grunt test:sauce:parallel
```
d. Si vous voulez afficher vos rapports de test dans les journaux de travail de test, cochez la case Activer le rapport de test et définissez le modèle de fichier de résultats de test sur test/*.xml.
Cliquez sur Enregistrer. A chaque exécution de votre pipeline, vos tests Sauce Labs s'exécuteront.

Configurer Delivery Pipeline en utilisant l'API

L'intégration d'outils Delivery Pipeline prend en charge les paramètres de configuration suivants que vous pouvez utiliser avec l'API HTTP Toolchain et les 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 pipeline.

paramètres d'intégration de l'outilDelivery Pipeline
Paramètre	Utilisation	Type	Argument Terraform	Description
nom	facultatif, pouvant être mis à jour	Chaîne	nom	Nom de cette intégration d'outils.