Partie 3 : Mise en place d'une chaîne d'outils pour CD

Ce tutoriel vous permet d'utiliser le modèle de chaîne d'outils pour le déploiement continu (CD). Le modèle est préconfiguré avec les paramètres. Vous pouvez valider et fournir votre configuration pour compléter le tutoriel.

Avant de commencer

  1. Terminer Mettre en place les prérequis.
  2. Compléter Mettre en place une chaîne d'outils CI.
  3. Voir la vidéo suivante :

  1. Reportez-vous aux DevSecOps pour déployer une application CD sécurisée.

Démarrage de la configuration de la chaîne d'outils CD

Le service Continuous Delivery fournit des modèles qui vous guident dans la configuration de la chaîne d'outils CD. Suivez les étapes pour accéder au modèle de la chaîne d'outils CD.

  1. À partir du " console IBM Cloud, cliquez sur l'icône " Menu, " Icône de menu > " Automatisation de la plate-forme > " Chaînes d'outils".
  2. Sur la page Chaînes d'outils, cliquez sur Créer une chaîne d'outils.
  3. Cliquez sur CD - Déployer une application sécurisée avec les pratiques DevSecOps pour afficher le modèle.

Paramétrage de la chaîne d'outils

La page Bienvenue résume l'objectif de la chaîne d'outils et propose des liens vers la documentation et le matériel connexe.

  1. Cliquez sur Start.

  2. Saisissez un nom unique pour la chaîne d'outils. Notez que la région de la chaîne d'outils peut différer de celle du cluster et de celle de Container Registry.

  3. Sélectionner une région et Sélectionner un groupe de ressources sont listés. Note vous pouvez modifier les régions.

  4. En option, vous pouvez Choisir la chaîne d'outils d'intégration continue (CI) associée dans la liste déroulante. Cela permet de copier une partie de la configuration de l'IC afin de faciliter l'installation de la chaîne d'outils CD. Note Il se peut que certaines des valeurs que vous avez déjà saisies soient écrasées.

  5. Cliquez sur Continu.

    Vous ne pouvez passer à l'étape suivante que si la configuration de l'étape en cours est terminée et valide. Vous pouvez à tout moment cliquer sur Retour pour afficher les étapes précédentes de l'installateur guidé. Tous les paramètres de configuration définis au cours des étapes successives sont conservés dans le programme d'installation de la chaîne d'outils.

    Certaines étapes comprennent un bouton de basculement vers la configuration avancée. Par défaut, ces étapes vous indiquent la configuration minimale. Toutefois, les utilisateurs avancés qui ont besoin d'un contrôle plus précis peuvent cliquer sur le bouton Passer à la configuration avancée pour afficher les options relatives à l'intégration sous-jacente.

Configuration des intégrations d'outils

Si vous avez déjà établi un lien avec une chaîne d'outils CI existante dans l'étape, le nom de la chaîne d'outils, la région, les référentiels et d'autres champs sont pré-remplis. Passez en revue les URL de référentiel, puis passez aux étapes suivantes.

Inventaire Ansible

  1. Sélectionnez l' URL e du référentiel de l'inventaire configuré dans votre chaîne d'outils CI.
  2. Cliquez sur Continu.

Problèmes

  1. Sélectionnez l' URL e du référentiel pour enregistrer les problèmes pendant l'exécution du pipeline CD. Note que vous utilisez un dépôt de problèmes existant qui a été créé pendant la chaîne d'outils CI.
  2. Cliquez sur Continu.

Configuration de pipeline

Le référentiel de configuration du pipeline contient des fichiers YAML et des scripts nécessaires au déploiement, aux tests et à d'autres tâches personnalisées.

  1. Accepter les paramètres par défaut pour Fournisseur de source.

    Si vous n'avez pas de référentiel de configuration, activez la bascule Configuration avancée et sélectionnez le type Cloner le référentiel. La chaîne d'outils clone la configuration d'exemple dans votre organisation Git. Pour plus d'informations sur les référentiels Git, consultez la section Configuration de votre Git Repos and Issue Tracking. Pour plus d'informations sur les scripts personnalisables, voir Scripts personnalisés.

  2. Saisissez un Nouveau nom de référentiel unique.

  3. Cliquez sur Continu.

Secrets

  1. Ce tutoriel utilise IBM Cloud® Secrets Manager comme chambre forte pour les secrets. Les champs Région, Groupe de ressources et Nom du service sont automatiquement remplis en fonction des choix disponibles. Cliquez sur les indicateurs déroulants pour voir les autres choix.
  2. Saisissez votre Secrets Manager nom d'instance.
  3. Sélectionnez le type d'autorisation dans la liste déroulante.
  4. Cliquez sur Continu.

Stockage des preuves

  1. Sélectionnez un Référentiel de preuves existant.
  2. Sélectionnez l' URL e de référentiel qui a été créée lors de la configuration de la chaîne d'outils d'intégration continue (CI). Pour plus d'informations sur le stockage des preuves, voir Preuves.
  3. Faites basculer le curseur du seau IBM Cloud Object Storage pour stocker toutes les preuves dans le seau IBM Cloud Object Storage.
  4. Cliquez sur Continu.

Compartiment cloud Object Storage

  1. Vérifier et accepter les détails automatiquement renseignés IBM Cloud Object Storage. Pour plus d'informations sur la configuration d'un seau pouvant servir de casier de preuves de conformité, voir Configuration de Object Storage pour le stockage de preuves.
  2. Fournissez votre clé API de service pour écrire dans une instance IBM Cloud Object Storage.
  3. Cliquez sur Continu.

Signature d'un artefact

  1. Vous pouvez également saisir Code Signing Certificate pour vérifier la validité des signatures pour les artefacts. Par exemple, les artefacts Docker qui sont construits et signés par le pipeline CI avant d'être déployés en production.
  2. Cliquez sur Continu.

Cible de déploiement

  1. Acceptez l'option Cluster unique (déploiement basé sur la poussée) pour déployer votre application vers des cibles telles que Virtual Server Instance ou personnaliser le processus de déploiement, utilisez l'option Personnalisée.
  2. Cliquez sur Continuer pour afficher la page du cluster.
  3. Saisissez le champ IBM Cloud API Key pour interagir avec l'outil CLI dans plusieurs tâches. Note une clé existante peut être importée d'un coffre-fort de secrets en cliquant sur l'icône de la clé.
  4. Verify your Région de la grappe, Groupe de ressources, Nom du groupe, and Espace de noms des clusters fields where your target cluster is created.
  5. Cliquez sur Continu.

Gestion des demandes de changement

  1. Accepter les valeurs renseignées pour la gestion des demandes de changement. Pour plus d'informations, voir Automatisation de la gestion des changements.
  2. Saisissez un Nouveau nom de référentiel unique.
  3. Définissez la Finalité de l'environnement cible comme Production.
  4. Définir les détails de l'environnement cible.
  5. Cliquez sur Continu.

Outils facultatifs

Slack

Configurez le Slack pour recevoir des notifications sur vos pull requests, ou les événements du pipeline CI. Vous pouvez également ajouter l'outil Slack après la création de la chaîne d'outils.

  1. Saisissez votre webhook Slack. Pour plus d'informations, voir Slack webhook.
  2. Saisissez votre canal Slack pour poster un message.
  3. Saisissez le Nom de l'équipe adverse. Par exemple, si l' URL de votre équipe est https://team.slack.com, le nom de l'équipe est team.
  4. Choisir Notifications Slack automatisées pour les événements pour lesquels vous souhaitez recevoir des notifications.
  5. Cliquez sur Continu.

En option, vous pouvez activer l'envoi de notifications avec la propriété d'environnement slack-notifications dans votre pipeline CD en utilisant 0 = off, and 1 = on.

Création de la chaîne d'outils CD

Les intégrations des différentes chaînes d'outils peuvent être configurées après la création du pipeline.

  1. Sur la page Résumé, cliquez sur Créer une chaîne d'outils, puis attendez que celle-ci soit créée.

caption-side=bottom"
DevSecOps CD toolchain créé DevSecOps CD toolchain créé

Exploration de la chaîne d'outils CD

  1. Maintenant que la chaîne d'outils CD est créée, cliquez sur la tuile cd-pipeline pour ouvrir et exécuter le pipeline de promotion.

Exécution du pipeline de promotion

Assurez-vous que le pipeline CI s'est exécuté correctement avant de lancer le pipeline de promotion.

  1. Cliquez sur cd-pipeline.

  2. Cliquez sur Exécuter pour le pipeline Déclencheur manuel de promotion.

  3. Cliquez sur Exécuter pour lancer le pipeline.

  4. Cliquez sur Déclencheur manuel de promotion > #1promotion-pipelinerun pipeline. Attendez la fin de l'exécution du pipeline de promotion et vérifiez le journal d'exécution.

    Le pipeline de promotion crée une pull request contenant le contenu de l'inventaire présent dans l'environnement source de l'inventaire, tel que la branche master, ciblant la branche de l'environnement cible de l'inventaire, telle que staging ou production.

  5. Une fois le pipeline de promotion terminé avec succès, le journal des tâches promote fournit un lien vers la pull request dans le dépôt d'inventaire. Le nom de la demande d'extraction est du format promote <inventory source environment> to <inventory target environment>, par exemple, promote master to prod

  6. Ouvrez la pull request dans votre navigateur à l'aide du lien fourni dans le journal. Complétez les informations dans les sections suivantes :

    • Priorité: (obligatoire) défini comme Critical, High, Moderate, Low, ou Planning.
    • Responsable de la demande de modification: (obligatoire) Email-ID du responsable.
    • Description complémentaire: description des modifications apportées à l'application.
    • Objectif: raison d'être des modifications apportées à l'application.
    • Explication de l'impact: impact du changement sur le comportement de l'application ou sur l'environnement.
    • Plan de secours: Etapes à suivre pour se retirer en cas d'échec du déploiement.

  7. Remplissez les champs de la Pull Request et enregistrez.

  8. Ajoutez l'étiquette EMERGENCY à votre pull request si les contrôles de conformité dans CI ont échoué et que vous voulez continuer avec le déploiement

  9. Fusionnez la demande d'extraction depuis Git Repos and Issue Tracking.

Les détails de la demande d'extraction sont utilisés pendant l'exécution du pipeline CD pour créer et mettre à jour le référentiel des demandes de changement.

Exécution du pipeline CD

Vous pouvez déclencher un pipeline de CD de manière manuelle ou automatique. Vous pouvez déclencher manuellement le pipeline CD à tout moment, mais si aucun changement n'est intervenu depuis le dernier déploiement réussi, le pipeline CD s'arrête prématurément car il n'y a rien à déployer. Vous pouvez ajouter et utiliser la variable force-redeploy pour réexécuter le CD sans modifier le code. Voir la capture d'écran réussie du DevSecOps CD pipeline.

caption-side=bottom"
DevSecOps Succès du pipeline de CD Succès du pipeline de CD DevSecOps

Vous pouvez trouver l'application d'exemple qui fonctionne dans l'espace de noms de production. L' URL de l'application se trouve dans le journal de la run stage sous-étape de l'étape prod deployment de l'exécution du pipeline CD. Utilisez cette URL pour vérifier que l'application fonctionne.

Etapes suivantes

Vous avez créé avec succès une chaîne d'outils CD DevSecOps, exécuté le cd-pipeline pour le déclencher manuellement dans l'environnement de production.

Poursuivez avec Mise en place d'une chaîne d'outils CC.