Créer un pipeline personnalisé

Créez un pipeline personnalisé pour déplacer les changements de votre environnement de développement vers votre environnement de production (ou votre instance cible) en dupliquant l’un ReleaseOps des playbooks.

Avant de commencer

Rôle requis : releaseops.pipeline_admin et playbook.admin ou_author

Pour en savoir plus sur les playbooks, reportez-vous à Exploring playbooks.

Procédure

1. Dupliquez l’un ReleaseOps des playbooks.
   1. Accédez à la Tous > Studio de workflow et sélectionnez le playbook souhaité.
   2. Saisissez un nom pour votre nouveau playbook et mettez à jour tous les autres détails requis.
   Pour plus d'informations, consultez Duplicate Playbooks.
2. Ajoutez ou mettez à jour des étapes dans le playbook comme vous le souhaitez.
   Remarque :

   Certaines étapes ont un sens à certaines parties du flux. Par exemple, l’analyseur de déploiement s’exécute avant l’état de déploiement Passer au test. D’autres étapes devront peut-être être exécutées après Passer au test ou après Exécuter les tests ATF. En règle générale, vous ne devez rien ajouter après Prêt pour le déploiement.

   Pour plus d'informations, consultez Add and configure a stage in a playbook.
3. Ajoutez ou mettez à jour des décisions dans le playbook selon vos besoins.
   Pour plus d'informations, consultez Decision activities.
4. Sélectionnez Activer pour finaliser vos mises à jour et rendre votre nouveau playbook disponible.
5. Créez un pipeline qui exploite votre nouveau playbook.
   1. Accédez à la Tous > ReleaseOps > Pipelines et sélectionnez New (Nouveau).
   2. Attribuez un nom à votre pipeline et sélectionnez des playbooks pour les champs Playbook d’évaluation et Playbook de mise en production .
      Vous pouvez utiliser vos propres playbooks personnalisés pour les deux, ou utiliser une combinaison de playbooks personnalisés et d’exemples.
   3. Cliquez avec le bouton droit sur l’en-tête du formulaire Pipeline et sélectionnez Enregistrer.
6. Dans votre pipeline nouvellement créé, localisez la liste connexe Instances de pipeline et sélectionnez Nouveau.
   1. Sélectionnez l’étiquette Test.
   2. Sélectionnez votre instance de déploiement.
   3. Sélectionnez Soumettre.

Exemple : créer un playbook d’évaluation

Créez un pipeline personnalisé pour déplacer les changements dans votre environnement de non-production en dupliquant le playbook d’évaluation de la demande de déploiement. Ajoutez l’analyseur de déploiement pour détecter s’il y a des changements de code dans le déploiement et ignorer les tests Automated Test Framework (ATF) pendant l’évaluation.

Avant de commencer

Rôle requis : releaseops.pipeline_admin et playbook.admin ou_author

Procédure

1. Dupliquez le playbook d’évaluation de la demande de déploiement.
   1. Accédez à la Tous > Studio de workflow et sélectionnez le playbook Deployment Request Assessment (Évaluation de la demande de déploiement ).
   2. Sélectionnez Dupliquer dans le menu Actions supplémentaires.
   3. Saisissez un nom pour votre nouveau playbook et mettez à jour tous les autres détails requis.
2. Ajoutez une nouvelle étape au playbook en sélectionnant l’icône + après Démarrer et saisissez une étiquette, par exemple Analyser le déploiement.
   Remarque :

   Certaines étapes ont un sens à certaines parties du flux. Par exemple, l’analyseur de déploiement s’exécute avant l’état de déploiement (Passer au test). D’autres étapes devront peut-être être exécutées après Passer au test ou après Exécuter les tests ATF. En règle générale, vous ne devez rien ajouter après Prêt pour le déploiement.
3. Ajoutez l’activité Exécuter l’analyseur de déploiement .
4. Sélectionnez l’activité Exécuter l’analyseur de déploiement nouvellement ajoutée pour la configurer.
   1. Sélectionnez l’onglet Automation (Automatisation) dans le modal d’options supplémentaires.
   2. Dans la section Entrées du modal, sélectionnez l’icône, puis Enregistrement parent : demande de déploiement.
   3. Sélectionnez Enregistrer et fermer.
5. Localisez la section Exécuter des tests ATF du playbook et ajoutez une nouvelle décision après l’activité Transition vers l’évaluation en sélectionnant l’icône +, puis en sélectionnant Ajouter une décision (si/alors).
   Pour plus d'informations, consultez Decision activities.
6. Sélectionnez la décision nouvellement ajoutée pour la configurer.
   1. Sélectionnez l’onglet Branches , puis saisissez une étiquette, par exemple Ignorer les tests.
   2. Sélectionnez Ajouter une condition.
   3. Dans le menu déroulant Champ, sélectionnez 1.1 Analyseur de déploiement > Sorties > A un changement de code.
   4. Sélectionnez cette option dans le menu déroulant Opérateur.
   5. Sélectionnez Faux dans le menu déroulant Vrai/Faux.
   6. Sélectionnez Enregistrer et fermer.
7. Passez la souris sur la branche Ignorer les tests, sélectionnez l’icône Faire glisser le nouveau connecteur et faites glisser le connecteur jusqu’à la jonction après la tâche Créer un échec de test.
   Confirmez que la branche par défaut est connectée à Exécuter des tests ATF pour le déploiement.
8. Sélectionnez Activer pour finaliser vos mises à jour et rendre votre nouveau playbook disponible.
9. Créez un pipeline qui exploite votre playbook d’évaluation.
   1. Accédez à la Tous > ReleaseOps > Pipelines et sélectionnez New (Nouveau).
   2. Attribuez un nom à votre pipeline et sélectionnez votre playbook nouvellement créé dans le champ Playbook d’évaluation .
   3. Sélectionnez et maintenez enfoncé (ou cliquez avec le bouton droit de la souris) l’en-tête sur le formulaire Pipeline, puis sélectionnez Enregistrer.
10. Dans votre pipeline nouvellement créé, localisez la liste connexe Instances de pipeline et sélectionnez Nouveau.
    1. Sélectionnez l’étiquette Test.
    2. Sélectionnez votre instance de déploiement.
    3. Sélectionnez Soumettre.

Résultats

Votre pipeline personnalisé, qui exploite le playbook personnalisé que vous avez créé à partir du playbook d’évaluation de demande de déploiement par défaut pour son étape d’évaluation, est maintenant prêt à l’emploi.

Remarque :

• L’étiquette d’instance de pipeline (dans l’exemple ci-dessus, l’étiquette de test saisie à l’étape 10a) est utilisée pour mapper la définition d’instance à l’instance telle que référencée dans le playbook. Le mappage de la définition d’instance avec l’étiquette d’instance permet à un playbook d’être utilisé par plusieurs définitions de pipeline avec des topologies différentes (mais le même processus). Par exemple, vous pouvez créer un autre enregistrement de pipeline et l’associer aux mêmes playbooks, mais définir un mappage d’instance de test différent.
• L’instance source du playbook est définie dans la demande de déploiement, de sorte que vous pouvez disposer de plusieurs environnements sources ou de développement pour une seule mise en production.
• L’instance de destination est définie dans la mise en production, de sorte que vous pouvez réutiliser le même pipeline pour la mise en production dans plusieurs environnements de destination ou de production.
• Seules les instances intermédiaires doivent être mappées.