Contenu connexe

• Initiation à Continuous Delivery
• Initiation aux clusters
• Initiation aux chaînes d'outils

Configuration du nom et de la région de la chaîne d'outils

Passez en revue les informations par défaut des paramètres de chaîne d'outils. Le nom de la chaîne d'outils l'identifie dans IBM Cloud. Veillez à ce qu'il n'existe qu'une seule chaîne d'outils de ce nom dans une même région et un même groupe de ressources IBM Cloud.

La région de la chaîne d'outils peut être différente de celle du cluster et du registre.

Sélectionnez la stratégie de déploiement

La chaîne d'outils crée un pipeline de déploiement continu pour déployer l'image d'application Docker sur le IBM Cloud® Kubernetes Service. Sélectionnez la stratégie de déploiement à utiliser. Selon la stratégie de déploiement que vous choisissez (Rolling, Blue-Green ou Canary), vous devez fournir plus de détails.

1. Cliquez sur la stratégie de déploiement que vous souhaitez utiliser pour votre chaîne d'outils.

   {: caption="

2. Cliquez sur Continu.

Configuration du code source de l'application

Dans l'étape Application, les options recommandées pour le repo du code source de l'application sont affichées par défaut. Pour afficher toutes les options disponibles pour l'intégration Git sous-jacente, cliquez sur Options avancées. Par défaut, la chaîne d'outils utilise l'exemple par défaut qui clone l'application exemple sous la forme d'un référentiel Git Repos and Issue Tracking hébergé par IBM.

Vous pouvez changer le nom de l'application repo. La région du repo reste la même que la région de la chaîne d'outils.

Le modèle de chaîne d'outils fournit un exemple d'application Spring Java™ utilisant une compilation Maven. Si vous souhaitez lier un référentiel d'application existant pour la chaîne d'outils, sélectionnez Apportez votre propre application et indiquez l'URL du référentiel. La chaîne d'outils prend en charge la liaison uniquement aux pensions Git Repos and Issue Tracking existantes.

Par défaut, le modèle de référentiel d'application est cloné dans votre organisation Git Repos and Issue Tracking. Pour modifier l'organisation, activez Options avancées et indiquez le propriétaire du référentiel.

Configuration du référentiel d'inventaire

Le référentiel d'inventaire enregistre les détails des artefacts générés par les chaînes d'outils d'intégration continue. Vous pouvez soit créer un nouveau dépôt d'inventaire qui soit un clone du modèle de dépôt d'inventaire, soit utiliser un dépôt d'inventaire existant que vous partagez entre plusieurs chaînes d'outils.

Par défaut, le modèle repo Inventory est cloné sur votre organisation Git Repos and Issue Tracking. Pour modifier l'organisation, sélectionnez Options avancées et indiquez le propriétaire du référentiel.

Secrets de stockage de sécurité

Plusieurs outils de cette chaîne d'outils nécessitent des secrets, tels qu'une clé d'API IBM Cloud. Vous devez stocker en toute sécurité tous les secrets dans un coffre et les faire référence comme requis par la chaîne d'outils.

A l'aide de IBM Cloud, vous pouvez choisir parmi diverses offres de gestion de secrets et de protection des données qui vous aident à protéger vos données sensibles et à centraliser votre secret. Dans l'étape Secrets, vous pouvez spécifier les intégrations de coffre à ajouter ou à supprimer de votre chaîne d'outils. Pour plus d'informations sur l'ajout et la suppression d'intégrations de coffre, y compris les prérequis et l'utilisation de conseils, voir Gestion des secrets IBM Cloud.

En utilisant des conseils dans un modèle, une chaîne d'outils est automatiquement renseignée avec des secrets préconfigurés ; vous n'avez pas besoin de sélectionner manuellement les secrets des intégrations de coffre qui sont associés à la chaîne d'outils.

Ce tutoriel utilise IBM Secrets Manager comme coffre des secrets.

{: caption="

IBM Secrets Manager stocke et applique des informations confidentielles telles que les clés d'API, la signature d'image ou les données d'identification HashiCorp qui font partie de votre chaîne d'outils.

Pour plus d'informations sur la gestion de vos secrets dans IBM Key Protect ou HashiCorp,, voir Secrets.

Configuration des détails de VPC

Configurez la chaîne d'outils en spécifiant des informations sur les instances VPC et Virtual Server (VSI).

Vous avez provisionné le VPC et le VSI à l'aide de IBM Cloud® Schematics et de Terraform lorsque vous avez sélectionné la stratégie de déploiement à utiliser.

• Région de cloud privé virtuel : Sélectionnez la région dans laquelle vous avez provisionné le VPC.
• Nom du cloud privé virtuel : Sélectionnez le VPC que vous avez mis à disposition à l'aide du modèle Terraform. Les options incluent tous les VPC disponibles dans la région sélectionnée.
• Nom d'utilisateur des instances VPC : Spécifiez le nom d'utilisateur que vous avez configuré lors de la mise à disposition de l'instance VPC. Tous les VSI de votre VPC nécessitent un nom d'utilisateur et une clé SSH pour se connecter et déployer cette instance.
• Clé SSH codée Base64 pour les instances VPC : Spécifiez la clé SSH privée dans le formulaire base64-encoded pour la clé SSH publique que vous avez configurée lorsque vous avez provisionné les instances VPC.

Configuration des détails de l'hôte de base

Le modèle Terraform crée également un VSI à utiliser en tant qu'hôte de base. Un hôte de base fournit un moyen sécurisé de se connecter aux VSIs de votre VPC pour effectuer des tâches de déploiement et de maintenance. L'hôte de base se connecte aux VSIs via SSH à l'aide des données d'identification (nom d'utilisateur et clé SSH) que vous avez configurées dans les détails de VPC.

La chaîne d'outils nécessite que vous vous connectez aux VSI au sein du VPC pour déployer l'application binaire, démarrer et arrêter l'application, et télécharger la dépendance de tiers pour exécuter l'application. Toutes ces tâches sont réalisées en utilisant SSH-Tunneling avec l'hôte Bastion. La chaîne d'outils utilise les mêmes informations d'identification pour se connecter à l'hôte Bastion que celles utilisées par l'hôte Bastion pour se connecter aux VSI.

• Hôte Bastion : Sélectionnez le VSI qui est mis à disposition en tant qu'hôte Bastion par le modèle Terraform.

Configuration des détails de Load Balancer

L'application exemple déployée sur les SIV de votre VPC affiche une page Web simple sur le port 8080. Pour rendre l'application disponible sur Internet en utilisant un nom DNS, et pour équilibrer la charge du trafic entre les multiples VSI qui exécutent l'application, le modèle Terraform prévoit un équilibreur de charge d'application. Tous les VSI qui exécutent l'application forment le pool de serveurs de backend pour l'équilibreur de charge.

La chaîne d'outils utilise les détails de l'équilibreur de charge et des deux pools de backend pour configurer et rediriger le trafic des applications en direct pendant le processus de déploiement bleu-vert. Le pool backend bleu et le pool backend vert contiennent le même nombre de VSI. A tout moment, un seul des pools sert activement le trafic en direct alors que l'autre reste inactif en exécutant une ancienne version de l'application. L'équilibreur de charge permute ou bascule le pool de backend qui sert le trafic en direct à chaque déploiement. Alors que le pool backend bleu est actuellement actif, le déploiement suivant déploie l'application sur les VSI du pool backend vert et le rend actif alors que le pool backend bleu est passif.

Configurez la chaîne d'outils en spécifiant des informations sur Load Balancer :

• Nom de l'équilibreur de charge : sélectionnez l'équilibreur de charge d'application mis à disposition par le modèle Terraform.
• Nom du pool de backend bleu : sélectionnez le pool Blue Backend que le modèle Terraform fournit à l'équilibreur de charge.
• Nom du pool d'arrière-plan vert : sélectionnez le pool Green Backend que les dispositions du modèle Terraform à l'équilibreur de charge.

Une fois les détails des étapes deployment target renseignée, passez à l'étape suivante.

Configurer le stockage des artefacts

Toute modification de la source déclenche le pipeline d'intégration continue. Lorsqu'une exécution d'intégration continue réussit, un artefact de construction ou binaire est créé et sauvegardé dans un stockage transitoire, puis déployé vers les VSI cibles.

{: caption="

Vous pouvez utiliser IBM Cloud Object Storage pour stocker des artefacts de génération transitoires dans la chaîne d'outils. Le pipeline d'intégration continue génère le fichier exécutable .jar pour l'exemple d'application Java Spring.

Vous pouvez également utiliser Artifactory si vous disposez d'une instance Artifactory de votre propre.

Exploration des pipelines

Vous pouvez explorer les pipelines pour comprendre le flux de la chaîne d'outils et les différentes opérations qui s'exécutent dans chaque pipeline. La chaîne d'outils que vous venez de créer contient trois pipelines :

• Pipeline de demande d'extraction : S'exécute lorsqu'un développeur fusionne les modifications de sa branche de développement à la branche principale, ou à toute autre branche du référentiel. Le pipeline de demande d'extraction exécute les opérations de test d'unité et d'analyse statique sur le code source de l'application.
• Pipeline d'intégration continue : S'exécute lorsque vous fusionnez une modification dans la branche principale du référentiel de code source d'application. Le pipeline d'intégration continue exécute le test d'unité, la couverture de code et les analyses statiques sur le code source de l'application, la vérification CIS et la vérification de nomenclature. Le pipeline de distribution continue génère également les artefacts de génération binaires et les télécharge sur IBM Cloud® Kubernetes Service, tel qu'il est configuré dans la chaîne d'outils. Et le pipeline d'intégration continue génère les métadonnées des artefacts de construction et les stocke dans le référentiel Inventory.
• Pipeline de déploiement continu : Déploie les artefacts de génération dans l'environnement de déploiement. Le pipeline vérifie le déploiement réussi de l'application en exécutant le contrôle de santé. Vous devez déclencher manuellement ce pipeline une fois le pipeline d'intégration en continu terminé. En fonction de la stratégie de déploiement que vous avez sélectionnée, d'autres déclencheurs sont ajoutés au pipeline de distribution continue.

Exécution de la demande d'extraction et des pipelines d'intégration continue

Pour démarrer le pipeline de demande d'extraction, créez une demande de fusion dans votre application repo :

1. Sur la page Présentation de la chaîne d'outils, sur la carte Référentiels, cliquez sur l'application du référentiel compliance-app-<timestamp>.
2. A partir du référentiel maître, créez une branche.
3. Mettez à jour un code dans l'exemple d'application de noeud ou le fichier readme et sauvegardez ces modifications.
4. Soumettez la demande de fusion.
5. Sur la page Présentation de la chaîne d'outils, sur la carte Référentiels, cliquez sur le référentielpr-pipeline pour lancer le pipeline de demande d'extraction. La demande de fusion correspondante dans votre application repo reste à l'état en attente jusqu'à ce que toutes les étapes du pipeline de demande d'extraction se terminent correctement.
6. Une fois que l'exécution du pipeline de demande d'extraction aboutit, vous pouvez la sélectionner pour explorer les étapes terminées.

Pour démarrer le pipeline d'intégration continue, fusionnez la demande de fusion d'intégration continue dans votre application repo :

1. Accédez à la demande de fusion.
2. Fusionner la demande afin que vos modifications soient copiées sur la branche principale de votre application repo. Le pipeline d'intégration continue est automatiquement déclenché.
3. Sur la page Présentation de la chaîne d'outils d'intégration continue, sur la carte Référentiels, cliquez sur le référentiel ci-pipeline pour démarrer le pipeline d'intégration continue.
4. Une fois l'exécution du pipeline d'intégration continue réussie, vous pouvez cliquer sur l'exécution du pipeline pour explorer les étapes terminées.

Pour évaluer si vous avez des défaillances dans l'exécution de votre pipeline, vérifiez l'étape finale de votre pipeline, qui dispose d'un évaluateur de pipeline.

Explorez le pipeline de distribution continue

La demande d'extraction et les pipelines d'intégration continue sont communs à toutes les stratégies de déploiement. Les modifications de conception et d'implémentation du pipeline de distribution continue sont basées sur la stratégie de déploiement que vous avez précédemment sélectionnée dans ce tutoriel.

Ce tutoriel montre comment fonctionne la stratégie de déploiement Blue-Green à l'aide de l'application exemple.

Explorez le déploiement Blue-Green

La stratégie de déploiement bleu-vert qui est utilisée dans ce tutoriel montre comment vous pouvez utiliser une stratégie de déploiement avec le service Continuous Delivery pour exécuter vos charges de travail de production sur VPC. Le pipeline de livraison continue fournit trois déclencheurs pour le déploiement bleu-vert. Vous pouvez démarrer un pipeline de livraison continue de l'une des manières suivantes :

• Déclenche manuellement le pipeline de distribution continue.
• Déclencheur automatique du pipeline de distribution continue après chaque action Merge dans le référentiel Inventory. Après la fusion, vous devez déclencher manuellement l'exécution du pipeline de distribution continue.
• Passez des déploiements bleus aux déploiements verts pour un retour en arrière automatisé.

Ce tutoriel montre comment fonctionne la stratégie de déploiement Blue-Green à l'aide de l'application exemple.

1. Exécutez le déclencheur manuel à partir du pipeline de distribution continue pour déployer la première version de l'application.

   

2. Localisez l'URL de l'application dans l'étape release du pipeline de distribution continue et cliquez sur l'URL pour vérifier que l'application est en cours d'exécution.

   

3. Mettez à jour le code de l'application et engagez vos modifications. Pour l'application exemple, mettez à jour le message de bienvenue :

   a. Sur la page Présentation de la chaîne d'outils, sur la carte Référentiels, cliquez sur l'exemple du référentiel d'application.

   b. Mettez à jour le message de bienvenue dans le fichier utils.js.

   c. Attendez que l'exécution du pipeline d'intégration continue ait abouti.

4. Exécutez le déclencheur manuel à partir du pipeline de distribution continue et attendez que l'exécution du pipeline de distribution continue ait abouti.

5. Vérifiez à nouveau l'URL de l'application pour confirmer que l'application mise à jour est déployée. Les deux versions de l'application s'exécutent simultanément. Tout le trafic réseau s'écoule vers l'application mise à jour.

6. Testez l'annulation en exécutant le déclencheur switch-blue-green à partir du pipeline de distribution continue. Attendez que l'exécution du pipeline du déclencheur de commutation ait abouti.

   {: caption="de la commutation du pipeline de livraison continue*

7. Vérifiez à nouveau l'URL de l'application pour confirmer que la version précédente de l'application s'affiche.

Vous pouvez exécuter le déclencheur de commutation plusieurs fois pour remplacer les versions précédentes et les dernières versions de l'application.