Configuration de votre pipeline CI/CD

REMARQUE

Pour savoir comment configurer le pipeline CI/CD pour Cloud Manager dans AEM as a Cloud Service, consultez ce lien.

La page suivante explique comment configurer le pipeline. Pour consulter d’autres informations conceptuelles sur le fonctionnement du pipeline, voir la section Présentation du pipeline CI/CD.

Présentation du flux

Vous pouvez configurer votre pipeline à partir de la vignette Paramètres du pipeline dans l’interface utilisateur de Cloud Manager.

Le responsable de déploiement est chargé de la configuration du pipeline. Pour ce faire, vous devez d’abord sélectionner une branche dans le référentiel git. La configuration du pipeline comprend :

  • la définition du déclencheur qui le démarrera ;
  • la définition des paramètres qui contrôlent le déploiement en production ;
  • la configuration des paramètres de test de performance.

Tutoriel vidéo

Configuration du pipeline dans Cloud Manager

La configuration du pipeline de production CI/CD définit le déclencheur qui lancera le pipeline, les paramètres contrôlant le déploiement en production et les paramètres de test de performances.

Configuration du pipeline

ATTENTION

Le pipeline ne peut être configuré que si le référentiel Git dispose d’au moins une branche et que la configuration du programme est terminée.

Avant de commencer le déploiement du code, vous devez configurer les paramètres de votre pipeline à partir de Cloud Manager.

REMARQUE

Vous pouvez modifier les paramètres du pipeline après la configuration initiale.

Ajout d’un nouveau pipeline de production à partir de la carte Pipelines

Une fois que vous avez configuré votre programme et que vous disposez au moins d’un environnement basé sur l’interface utilisateur de Cloud Manager, vous êtes prêt à ajouter un pipeline de production.

Pour configurer le comportement et les préférences de votre pipeline de production, procédez comme suit :

  1. Accédez à la carte Pipelines à partir de la page Aperçu du programme.

  2. Cliquez sur +Ajouter et sélectionnez Ajouter un pipeline de production.

  3. La boîte de dialogue Ajouter un pipeline de production s’affiche.

    1. Saisissez le Nom du pipeline. Vous pouvez choisir le Référentiel et la Branche Git.

    2. Vous pouvez configurer le Déclencheur de déploiement et le Comportement en cas d’échec de mesure grave à partir des Options de déploiement.

      Vous pouvez affecter les déclencheurs de déploiement suivants au démarrage du pipeline :

      • Manuel : l’utilisation de l’interface lance le pipeline manuellement.
      • Lors des modifications Git : démarre le pipeline CI/CD chaque fois que des validations sont ajoutées à la branche git configurée. Même si vous sélectionnez cette option, vous pouvez toujours démarrer le pipeline manuellement.

      Lors de la configuration ou de la modification du pipeline, le responsable de déploiement peut définir le comportement du pipeline en cas d’échec important à l’un des points de contrôle qualité.

      Cela s’avère utile pour les clients qui souhaitent davantage de processus automatisés. Les options disponibles sont les suivantes :

      • Demander à chaque fois : il s’agit du paramètre par défaut, qui nécessite une intervention manuelle lors de n’importe quel échec important.
      • Annuler immédiatement en cas d’échec : si cette option est sélectionnée, le pipeline sera annulé chaque fois qu’un échec important se produira. Cette option émule essentiellement un utilisateur rejetant manuellement chaque échec.
      • Continuer immédiatement : si cette option est sélectionnée, le pipeline se poursuit automatiquement chaque fois qu’un échec important se produit. Cette option émule essentiellement la validation manuelle de l’utilisateur à chaque échec.
    3. Sélectionnez les Options de déploiement.

      • Les fonctions Approuver après le déploiement dans l’environnement d’évaluation fonctionnent de la même manière que l’approbation avant le déploiement en production, mais ce processus se produit immédiatement après l’étape de déploiement dans l’environnement intermédiaire, c’est-à-dire avant que les tests ne soient effectués, contrairement à l’approbation avant le déploiement en production, qui est effectuée une fois tous les tests terminés.

      • Ignorer les modifications de la répartition de charge ignore les modifications.

    4. Sélectionnez la Configuration du Dispatcher pour l’environnement intermédiaire. Saisissez le chemin d’accès, sélectionnez l’action dans Type, puis cliquez sur Ajouter un chemin. Vous pouvez spécifier jusqu’à 100 chemins par environnement.

    5. Sélectionnez les Options de déploiement pour la production. Définissez maintenant les paramètres contrôlant le déploiement en production.

      Les trois options disponibles sont les suivantes :

      • Utiliser l’approbation GoLive : un déploiement doit être approuvé manuellement par un propriétaire d’entreprise, un responsable de projet ou un responsable de déploiement via l’interface utilisateur Cloud Manager.

      • Planifié : cette option permet à l’utilisateur d’activer le déploiement en production planifié.

        REMARQUE

        Si l’option Planifié est sélectionnée, vous pouvez planifier le déploiement en production sur le pipeline après le déploiement en environnement intermédiaire (et Utiliser l’approbation GoLive, si cette option a été activée) pour attendre la définition d’une planification. L’utilisateur peut également choisir d’exécuter le déploiement en production immédiatement.

        Consultez Déploiement de votre code pour définir la planification du déploiement ou exécuter la production immédiatement.

        • Utiliser la supervision par l’ingénieur du service client : un ingénieur du service client participe au démarrage du déploiement. Lors de la configuration ou de la modification du pipeline lorsque la supervision par l’ingénieur du service client est activée, le responsable de déploiement peut sélectionner l’une des options suivantes :

          • Tout ingénieur du service client : fait référence à tout ingénieur du service client disponible.
          • Mon ingénieur du service client : fait référence à un ingénieur du service client spécifique affecté au client ou un remplaçant, si l’ingénieur du service client est absent du bureau.
    6. Paramétrez les Configurations du Dispatcher pour la production. Saisissez le chemin d’accès, sélectionnez l’action dans Type, puis cliquez sur Ajouter un chemin. Vous pouvez spécifier jusqu’à 100 chemins par environnement.

      En tant que responsable de déploiement, vous avez la possibilité de configurer un ensemble de chemins de contenu qui seront invalidés ou purgés du cache du Dispatcher AEM des instances de publication, lors de la configuration ou de la modification du pipeline.

      Vous pouvez configurer un ensemble distinct de chemins pour le déploiement Intermédiaire et Production. Si elles sont configurées, ces actions de cache sont exécutées dans le cadre de l’étape du pipeline de déploiement, juste après le déploiement des packages de contenu. Ces paramètres utilisent le comportement du Dispatcher AEM standard : invalider effectue une invalidation du cache, comme lorsque le contenu est activé d’Author vers Publish ; purger effectue une suppression de cache.

      En règle générale, l’utilisation de l’action invalider est préférable mais il se peut que la purge soit requise, notamment lors de l’utilisation des bibliothèques clients HTML AEM.

      REMARQUE

      Pour plus d’informations sur la mise en cache du Dispatcher, consultez Présentation du Dispatcher.

  4. Cliquez sur Continuer une fois que vous avez sélectionné toutes les options.

  5. Sélectionnez vos options au cours de l’étape de Test dans l’environnement intermédiaire. Vous pouvez configurer des tests de performance AEM Sites et AEM Assets, selon les produits sous licence que vous possédez. Pour plus d’informations, consultez Tests de performance.

    1. Sélectionnez vos options dans Diffusion de contenu de sites/poids de la charge distribuée. Consultez AEM Sites en test de performance pour plus d’informations.

    2. Sélectionnez vos options dans Distribution des tests de performance des ressources. Consultez AEM Assets en test de performance pour plus d’informations.

  6. Cliquez sur Enregistrer pour terminer l’ajout du pipeline de production.

Modification d’un pipeline de production

Vous pouvez modifier les configurations de pipeline à partir de la page Aperçu du programme.

Pour modifier le pipeline configuré, procédez comme suit :

  1. Accédez à la carte Pipelines à partir de la page Aperçu du programme.

  2. Cliquez sur dans la carte Pipelines et cliquez sur Modifier, comme illustré ci-dessous.

  3. La boîte de dialogue Modifier le pipeline de production s’affiche.

    1. L’onglet Configuration vous permet de mettre à jour le Nom du pipeline, le Référentiel, la Branche Git, le Déclencheur de déploiement, le Comportement en cas d’échec de mesure grave, les Options de déploiement et les Configurations du Dispatcher.

      REMARQUE

      Consultez Ajout et gestion des référentiels pour savoir comment ajouter et gérer des référentiels dans Cloud Manager.

    2. L’onglet de Test dans l’environnement intermédiaire vous offre la possibilité de sélectionner à nouveau les options dans Diffusion de contenu de sites/poids de la charge distribuée et Distribution des tests de performance des ressources.

  4. Cliquez sur Mettre à jour une fois que vous avez terminé de modifier le pipeline.

Autres actions de pipeline de production

Exécution d’un pipeline de production

Vous pouvez exécuter le pipeline de production à partir de la carte Pipelines :

  1. Accédez à la carte Pipelines à partir de la page Aperçu du programme.

  2. Cliquez sur dans la carte Pipelines et cliquez sur Exécuter, comme illustré ci-dessous.

Suppression d’un pipeline de production

Vous pouvez supprimer le pipeline de production de la carte Pipelines :

  1. Accédez à la carte Pipelines à partir de la page Aperçu du programme.

  2. Cliquez sur dans la carte Pipelines et cliquez sur Supprimer, comme illustré ci-dessous.

    REMARQUE

    Un utilisateur disposant du rôle Gestionnaire de déploiement peut désormais supprimer le pipeline de production en libre-service via l’option Supprimer de la carte Pipeline.

Pipelines de qualité de code et hors production uniquement

En plus du pipeline principal qui se déploie vers les environnements intermédiaire et de production, les clients peuvent configurer des pipelines supplémentaires, appelés Pipelines hors production. Ces pipelines exécutent toujours les étapes de génération et de qualité de code. Si besoin est, elles peuvent aussi déployer vers l’environnement Adobe Managed Services.

Tutoriel vidéo

Pipelines hors production et de la qualité du code uniquement de Cloud Manager

Les pipelines CI/CD hors production sont divisés en deux catégories : les pipelines de qualité du code et les pipelines de déploiement. Les pipelines de qualité du code canalisent tout le code d’une branche Git pour génération et évaluation par rapport à l’analyse de la qualité du code de Cloud Manager.

Ajout d’un pipeline hors production

Sur l’écran d’accueil, ces pipelines sont répertoriés dans une nouvelle carte :

  1. Accédez à la carte Pipelines à partir de l’écran d’accueil de Cloud Manager. Cliquez sur +Ajouter et sélectionnez Ajouter un pipeline hors production.

  2. La boîte de dialogue Ajouter un pipeline hors production s’affiche. Sélectionnez le type de pipeline que vous souhaitez créer, au choix : Pipeline de la qualité du code ou Pipeline de déploiement.

    Vous pouvez également configurer le Déclencheur de déploiement et le Comportement en cas d’échec de mesure grave à partir des Options de déploiement. Cliquez sur Continuer.

  3. Le nouveau pipeline hors production s’affiche désormais dans la variable carte Pipelines.

    Le pipeline s’affiche sur la carte de l’écran d’accueil avec trois actions, comme illustré ci-dessous :

    • Ajouter : permet d’ajouter un nouveau pipeline.
    • Accéder aux informations sur le référentiel : permet à l’utilisateur d’obtenir les informations nécessaires pour accéder au référentiel Git de Cloud Manager.
    • En savoir plus : suivez ce lien pour en savoir plus sur les ressources de documentation du pipeline CI/CD.

Modification d’un pipeline hors production

Vous pouvez modifier les configurations de pipeline à partir de la Carte Pipelines de la page d’Aperçu du programme.

Suivez les étapes ci-dessous pour modifier le pipeline hors production configuré :

  1. Accédez à la carte Pipelines à partir de la page Aperçu du programme.

  2. Sélectionnez le pipeline hors production et cliquez sur . Cliquez sur Modifier comme illustré dans la figure ci-dessous.

  3. La boîte de dialogue Modifier le pipeline de production vous permet de mettre à jour le Nom du pipeline, le Référentiel, la Branche Git, le Déclencheur de déploiement et le Comportement en cas d’échec de mesure grave.

    REMARQUE

    Consultez Ajout et gestion des référentiels pour savoir comment ajouter et gérer des référentiels dans Cloud Manager.

    Vous pouvez affecter les déclencheurs de déploiement suivants au démarrage du pipeline :

    • Manuel : l’utilisation de l’interface lance le pipeline manuellement.
    • Lors des modifications Git : démarre le pipeline CI/CD chaque fois que des validations sont ajoutées à la branche git configurée. Même si vous sélectionnez cette option, vous pouvez toujours démarrer le pipeline manuellement.

    Lors de la configuration ou de la modification du pipeline, le responsable de déploiement peut définir le comportement du pipeline en cas d’échec important à l’un des points de contrôle qualité. Cela s’avère utile pour les clients qui souhaitent davantage de processus automatisés. Les options disponibles sont les suivantes :

    • Demander à chaque fois : il s’agit du paramètre par défaut, qui nécessite une intervention manuelle lors de n’importe quel échec important.
    • Annuler immédiatement en cas d’échec : si cette option est sélectionnée, le pipeline sera annulé chaque fois qu’un échec important se produira. Cette option émule essentiellement un utilisateur rejetant manuellement chaque échec.
    • Continuer immédiatement : si cette option est sélectionnée, le pipeline se poursuit automatiquement chaque fois qu’un échec important se produit. Cette option émule essentiellement la validation manuelle de l’utilisateur à chaque échec.
  4. Cliquez sur Mettre à jour une fois terminée la modification du pipeline hors production.

Autres actions de pipeline hors production

Exécution d’un pipeline hors production

Vous pouvez exécuter le pipeline de production à partir de la carte Pipelines :

  1. Accédez à la carte Pipelines à partir de la page Aperçu du programme.

  2. Cliquez sur dans la carte Pipelines et cliquez sur Exécuter, comme illustré ci-dessous.

Suppression d’un pipeline hors production

Vous pouvez supprimer le pipeline de production de la carte Pipelines :

  1. Accédez à la carte Pipelines à partir de la page Aperçu du programme.

  2. Cliquez sur dans la carte Pipelines et cliquez sur Supprimer, comme illustré ci-dessous.

Étapes suivantes

Une fois que vous avez configuré le pipeline, vous devez déployer votre code.

Pour plus d’informations, consultez Déploiement de votre code.

Sur cette page