Ajout d’un pipeline de production configuring-production-pipelines

Découvrez comment créer et configurer des pipelines de production à l’aide de Cloud Manager afin de déployer votre code. Si vous souhaitez d’abord obtenir une vue d’ensemble plus conceptuelle du fonctionnement des pipelines dans Cloud Manager, reportez-vous au document Pipelines CI/CD.

Vue d’ensemble overview

En utilisant le volet Paramètres du pipeline dans Cloud Manager, vous pouvez créer deux types de pipelines différents.

  • Pipelines de production  : un pipeline de production est un pipeline spécialement conçu, composé d’une série d’étapes coordonnées pour mener le code source depuis le référentiel Git jusqu’à la production.
  • Pipelines hors production - un pipeline hors production sert principalement à exécuter des analyses de qualité du code ou à déployer le code source dans un environnement de développement.

Ce document se concentre sur les pipelines de production. Pour plus d’informations sur la configuration des pipelines hors production, voir le document Configurer des pipelines hors production.

Le rôle du responsable du déploiement  : il est chargé de la configuration du pipeline. La configuration du pipeline comprend :

  1. la définition du déclencheur qui démarrera le pipeline ;
  2. La définition des paramètres qui contrôlent le déploiement en production ;
  3. La configuration des paramètres de test de performance.
NOTE
Un pipeline ne peut être configuré que si le référentiel Git qui lui est associé dispose d’au moins une branche et que la configuration du programme est terminée.

Ajouter un nouveau pipeline de production adding-production-pipeline

Une fois que vous avez utilisé l’interface d’utilisation de Cloud Manager pour configurer votre programme et que vous disposez d’au moins un environnement, vous pouvez ajouter un pipeline de production.

  1. Connectez-vous à Cloud Manager à l’adresse my.cloudmanager.adobe.com et sélectionnez l’organisation et le programme appropriés.

  2. Accédez à la carte Pipelines à partir de la page Vue d’ensemble du programme.

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

    Ajout d’un pipeline de production

  4. La boîte de dialogue Ajout d’un pipeline de production s’ouvre sur l’onglet de Configuration où plusieurs options de votre pipeline doivent être définies. Ces options sont regroupées en sections réductibles et sont décrites dans les étapes suivantes.

    1. Attribuez un nom explicite à votre pipeline dans le champ Nom du pipeline.

    2. Sous la section Code source, définissez où le pipeline récupère le code qu’il traite.

      • Référentiel  : définit à partir de quel référentiel Git le pipeline doit récupérer le code.
      note tip
      TIP
      Voir le document Configuration du programme pour découvrir comment ajouter et gérer des référentiels dans Cloud Manager.
      • Branche Git  : définit à partir de quelle branche le pipeline sélectionné doit récupérer le code.
      • Emplacement du code  : définit le chemin d’accès dans la branche du référentiel sélectionné à partir duquel le pipeline doit récupérer le code.

      Définition des référentiels pour le pipeline

    3. Sous la section Environnements, vous définissez ce qui déclenche un déploiement et comment il doit être déployé par environnement.

      1. Dans la section ÉTAPE, vous pouvez définir la manière dont le pipeline se déploie vers votre environnement d’évaluation.

        • Déclencheur de déploiement - vous disposez des options suivantes pour définir les déclencheurs de déploiement pour démarrer le pipeline.

          • Manuel  : démarrez manuellement le pipeline à l’aide de l’interface d’utilisation de Cloud Manager.
          • Lors des modifications Git  : démarrez le pipeline CI/CD lorsque des validations sont ajoutées à la branche Git configurée. Avec cette option, vous pouvez toujours démarrer le pipeline manuellement, si nécessaire.
        • Comportement en cas d’échecs de mesure importants - lors de la configuration ou de la modification du pipeline, le responsable de déploiement peut définir le comportement du pipeline lorsqu’un échec important est rencontré à l’un des points de contrôle qualité. Les options disponibles sont les suivantes :

          • Demander à chaque fois  : paramètre par défaut, qui nécessite une intervention manuelle lors de n’importe quel échec important.
          • Échouer immédiatement  : le pipeline sera interrompu dès qu’un échec important aura lieu. Il s’agit de l’émulation d’un utilisateur ou d’une utilisatrice qui rejette manuellement chaque échec.
          • Continuer immédiatement  : le pipeline se poursuivra automatiquement chaque fois qu’un échec important se produira. Il s’agit de l’émulation d’un utilisateur ou d’une utilisatrice qui approuve manuellement chaque échec.

        Déclencheur de déploiement

        • Options de déploiement - vous pouvez accélérer certaines tâches de déploiement.

          • Approbation après le déploiement d’évaluation - cette approbation a lieu après le déploiement dans l’environnement d’évaluation avant que tout test ne soit effectué. Sinon, l’approbation se produit avant le déploiement en production, qui est effectué une fois tous les tests terminés.

          • Ignorer les modifications de la répartition de charge - les modifications de la répartition de charge ne sont pas effectuées.

        Options de déploiement intermédiaire

        • Configuration du Dispatcher  : le rôle de la personne Responsable de déploiement consiste à configurer un ensemble de chemins de contenu qui sont soit invalidés soit vidés du cache d’AEM Dispatcher lorsqu’un pipeline est exécuté. 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 modules de contenu. Ces paramètres utilisent le comportement standard d’AEM Dispatcher. Pour effectuer la configuration, procédez comme suit :

          1. Sous CHEMIN, fournissez un chemin d’accès au contenu.

          2. Sous TYPE, sélectionnez l’action à effectuer sur ce chemin.

            • Purge - videz le cache.
            • Invalider - effectuez une invalidation du cache, comme lorsque le contenu est activé d’une instance de création vers une instance de publication.
          3. Cliquez sur Ajouter un chemin pour ajouter votre chemin spécifié. Vous pouvez ajouter jusqu’à 100 chemins par environnement.

        Configuration de Dispatcher

        note tip
        TIP
        En règle générale, l’utilisation de l’action Invalider est préférable, mais il peut y avoir des cas où la purge est nécessaire, notamment lors de l’utilisation des bibliothèques clientes HTML d’AEM.
      2. Dans la section PRODUCTION, vous pouvez définir la manière dont le pipeline se déploie dans votre environnement de production.

        • Options de déploiement - vous pouvez définir les paramètres contrôlant le déploiement en production.

          • Utiliser l’approbation de mise en production  : une personne ayant le rôle de Propriétaire d’entreprise, Responsable de projet ou Responsable de déploiement via l’interface d’utilisation de Cloud Manager doit approuver manuellement un déploiement.

          • Planifié  : interrompt le pipeline avant le déploiement en production pour permettre sa planification. Si cette option est sélectionnée, le pipeline s’arrête après le déploiement dans l’environnement d’évaluation et demandera à l’utilisateur ou à l’utilisatrice quelle action entreprendre.

            • Now  : déploie immédiatement en production, terminant ainsi le pipeline.
            • Date  : permet à l’utilisateur ou à l’utilisatrice de planifier une heure à laquelle le déploiement doit être terminé.
            • Arrêter l’exécution  : interrompt le déploiement en production.
          note tip
          TIP
          Voir la section Déploiement du code pour découvrir comment définir le planning de déploiement ou exécuter le pipeline immédiatement.
          • Solliciter la supervision par l’équipe d’ingénierie du service client (CSE)  : si cette option est choisie, une personne faisant partie de l’équipe d’ingénierie du service client est engagée pour véritablement démarrer le déploiement. Lors de la création ou de la modification d’un pipeline lorsque cette option est activée, le rôle Responsable de déploiement dispose des options suivantes.

            • Toute personne faisant partie de l’équipe d’ingénierie du service client  : permet à un ingénieur ou à une ingénieure du service client disponible de démarrer le déploiement.
            • Ma personne faisant partie de l’équipe d’ingénierie du service client  : permet uniquement à la personne faisant partie de l’équipe d’ingénierie du service client spécifique affectée au client ou à la cliente de démarrer le déploiement. Cette option s’applique également à la personne remplaçante désignée de l’ingénieur ou de l’ingénieure du service client indisponible.

          Options de déploiement en production

        • Configuration du Dispatcher  : définissez la configuration du Dispatcher pour votre environnement de production. Les options sont identiques à celles de l’environnement d’évaluation.

  5. Cliquez sur Continuer pour accéder à l’onglet Tests de l’environnement d’évaluation où vous pouvez configurer les tests de performances d’AEM Sites et d’AEM Assets, en fonction des produits sous licence que vous possédez.

    note tip
    TIP
    Voir la section Test de qualité du code pour plus de détails sur les options disponibles dans l’onglet Tests de l’environnement d’évaluation.
    1. Dans la section Diffusion de contenu de sites/poids de la charge distribuée, vous configurez les tests de performance du site en fonction de la pondération des requêtes de page parmi trois ensembles de pages. Vous pouvez activer ou désactiver les ensembles de pages selon vos besoins.

      • Pages dynamiques populaires
      • Autres pages dynamiques
      • Nouvelles pages

      Poids de charge des sites

    2. Sous la section Distribution des tests de performances des ressources, vous définissez la distribution de test des images et des PDF ainsi que vos propres ressources de test.

      • Images - réglez le curseur pour ajuster la répartition du test entre les images et les PDF.

      • PDF - réglez le curseur pour ajuster la répartition du test entre les images et les PDF.

      • Définissez vos propres ressources personnalisées en les chargeant.

        1. FORMAT - choisissez si votre ressource personnalisée est un PDF ou une image.
        2. NOM DE FICHIER - utilisez le bouton du navigateur de fichiers pour sélectionner une image sur votre ordinateur local.
        3. Ajouter un fichier test - cliquez pour charger la ressource sélectionnée.

      Distribution des tests des ressources

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

Étapes suivantes the-next-steps

Une fois que vous avez configuré le pipeline, vous devez déployer votre code. Voir la section Déploiement du code pour plus d’informations.

Tutoriel vidéo video-tutorial-one

Cette vidéo présente une vue d’ensemble du processus de création de pipeline, détaillé dans ce document.

recommendation-more-help
c6cdc82b-cee9-48e0-a6ee-48149d5e72c3