Configurer des pipelines hors production

Découvrez comment configurer des pipelines hors production afin de tester la qualité de votre code avant le déploiement dans des environnements de production.

Un utilisateur doit disposer de la variable Responsable de déploiement rôle pour configurer les pipelines hors production.

Pipelines hors production

Outre les pipelines de production qui se déploient sur les environnements d’évaluation et de production, vous pouvez également configurer des pipelines hors production pour valider votre code.

Il existe deux types de pipelines hors production :

• Pipelines de qualité du code - ceux-ci exécutent des analyses de qualité du code sur le code dans une branche Git et exécutent les étapes de création et de qualité du code.
• Pipelines de déploiement - outre l’exécution des étapes de création et de qualité du code, telles que les pipelines de qualité du code, ces pipelines déploient le code dans un environnement hors production.

Ajout d’un nouveau pipeline hors production

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

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 depuis l’écran d’accueil de Cloud Manager. Cliquez sur +Ajouter et sélectionnez Ajouter un pipeline hors production.

   

3. Sous l’onglet Configuration de la boîte de dialogue Ajouter un pipeline hors production, sélectionnez le type de pipeline hors production que vous souhaitez ajouter.

   • Pipeline de qualité du code – Créez un pipeline qui génère votre code, exécute des tests unitaires et évalue la qualité du code, mais ne le déploie PAS.
   • Pipeline de déploiement – Créez un pipeline qui génère votre code, exécute des tests unitaires, évalue la qualité du code et le déploie dans un environnement.

   

4. Fournissez un Nom du pipeline hors production pour identifier votre pipeline avec les informations supplémentaires suivantes.

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

     • Manuel - utilisez cette option pour démarrer manuellement le pipeline.
     • Lors des modifications Git – Cette option démarre le pipeline CI/CD chaque fois que des validations sont ajoutées à la branche Git configurée. Avec cette option, vous pouvez toujours démarrer le pipeline manuellement, si nécessaire.

5. Si vous choisissez de créer un pipeline de déploiement, vous devez également définir le comportement des échecs de mesure importants.

   • Demander à chaque fois – Ce comportement est le paramètre par défaut qui nécessite une intervention manuelle lors de tout échec important.
   • Défaillance immédiate – Si cette option est sélectionnée, le pipeline sera interrompu dès qu’une défaillance importante aura lieu. Il s’agit essentiellement de l’émulation d’un utilisateur ou d’une utilisatrice qui rejette manuellement chaque échec.
   • Continuer immédiatement – Si cette option est sélectionnée, le pipeline se poursuivra automatiquement chaque fois qu’une défaillance importante se produira. Il s’agit essentiellement de l’émulation d’un utilisateur ou d’une utilisatrice qui approuve manuellement chaque échec.

6. Cliquez sur Continuer.

7. Dans l’onglet Code source de la boîte de dialogue Ajouter un pipeline hors production, vous devez sélectionner le type de code que le pipeline doit traiter.

   • Code full stack
   • Déploiement ciblé

Voir Pipelines CI/CD pour plus d’informations sur les types de pipelines.

Les étapes de création de votre pipeline hors production varient en fonction du type de code source sélectionné. Suivez les liens ci-dessus pour accéder à la section suivante de ce document afin de terminer la configuration de votre pipeline.

Code full stack

Un pipeline de code full stack déploie simultanément des versions de code front-end et back-end contenant une ou plusieurs applications de serveur AEM avec une configuration HTTPD/Dispatcher.

Pour terminer la configuration du pipeline hors production de code full stack, procédez comme suit.

1. Dans l’onglet Code source, vous devez définir les options suivantes.

   • Environnements de déploiement éligibles - Si votre pipeline est un pipeline de déploiement, vous devez sélectionner les environnements à déployer.
   • Référentiel – Cette option définit à partir de quel référentiel Git le pipeline doit récupérer le code.
   CONSEIL

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

   • Branche Git – Cette option définit à partir de quelle branche le pipeline sélectionné doit récupérer le code.

     • Saisissez les premiers caractères du nom de la branche et la fonction de saisie automatique de ce champ. Vous pouvez ainsi trouver les branches correspondantes que vous pouvez sélectionner.

   • Ignorer la configuration de niveau Web – Lorsque cette case est cochée, le pipeline ne déploie pas votre configuration de niveau web.

   • Pipeline – Si votre pipeline est un pipeline de déploiement, vous pouvez choisir d’exécuter une phase de test. Cochez les options que vous souhaitez activer pour cette phase. Si aucune des options n’est sélectionnée, la phase de test n’est pas affichée pendant l’exécution du pipeline.

     • Tests fonctionnels du produit – Exécutez des tests fonctionnels du produit dans l’environnement de développement.
     • Tests fonctionnels personnalisés – Exécutez des tests fonctionnels personnalisés dans l’environnement de développement.
     • Tests de l’interface utilisateur personnalisée – Exécutez des tests de l’interface utilisateur personnalisée pour les applications personnalisées.
     • Audit de l’expérience - Exécuter Audit de l’expérience

   

2. Cliquez sur Enregistrer.

Le pipeline est enregistré et vous pouvez maintenant gérer vos pipelines sur la carte Pipelines sur la page Aperçu du programme.

Déploiement ciblé

Un déploiement ciblé déploie le code uniquement pour les parties sélectionnées de votre application AEM. Dans un tel déploiement, vous pouvez choisir Inclure l’un des types de code suivants :

• Config - Configurez les paramètres de votre environnement AEM, les tâches de maintenance, les règles CDN, etc.
  • Voir le document Règles de filtre de trafic incluant des règles WAF pour savoir comment gérer les règles de filtrage du trafic dans votre référentiel afin qu’elles soient déployées correctement.
• Code front-end - Configurez JavaScript et CSS pour le front-end de votre application AEM.
  • Avec les pipelines front-end, les développeurs front-end bénéficient d’une plus grande indépendance et le processus de développement peut être accéléré.
  • Consultez le document Développement de sites avec le pipeline front-end pour connaître le fonctionnement de ce processus ainsi que certaines considérations à prendre en compte pour en tirer le meilleur parti.
• Configuration du niveau web - Configurez les propriétés du dispatcher pour stocker, traiter et diffuser des pages web au client.

Les étapes de création de votre pipeline de déploiement ciblé hors production sont les mêmes une fois que vous avez choisi un type de déploiement.

1. Choisissez le type de déploiement dont vous avez besoin.

1. Définissez la variable Environnements de déploiement éligibles.

   • Si votre pipeline est un pipeline de déploiement, vous devez sélectionner les environnements à déployer.

2. Sous Code source, définissez les options suivantes :

   • Référentiel – Cette option définit à partir de quel référentiel Git le pipeline doit récupérer le code.
   CONSEIL

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

   • Branche Git – Cette option définit à partir de quelle branche le pipeline sélectionné doit récupérer le code.
     • Saisissez les premiers caractères du nom de la branche et la fonction de saisie automatique de ce champ. Elle trouve les branches correspondantes que vous pouvez sélectionner.
   • Emplacement du code - Cette option 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.

   

3. Cliquez sur Enregistrer.

Le pipeline est enregistré et vous pouvez maintenant gérer vos pipelines sur la carte Pipelines sur la page Aperçu du programme.

Lors de l’exécution d’un pipeline de déploiement ciblé, les configurations telles que les configurations WAF ; seront déployés, à condition qu’ils soient enregistrés dans l’environnement, le référentiel et la branche que vous avez définis dans le pipeline.

Ignorer les packages du Dispatcher

Si vous souhaitez que les packages du Dispatcher soient créés dans le cadre de votre pipeline, mais que vous ne souhaitez pas qu’ils soient publiés pour créer du stockage, vous pouvez désactiver leur publication, ce qui peut réduire la durée d’exécution du pipeline.

La configuration suivante permettant de désactiver la publication des packages du Dispatcher doit être ajoutée via le fichier pom.xml de votre projet. Elle est basée sur une variable d’environnement, qui sert d’indicateur que vous pouvez définir dans le conteneur de génération de Cloud Manager pour définir quand les packages du Dispatcher doivent être ignorés.

<profile>
  <id>only-include-dispatcher-when-it-isnt-ignored</id>
  <activation>
    <property>
      <name>env.IGNORE_DISPATCHER_PACKAGES</name>
      <value>!true</value>
    </property>
  </activation>
  <modules>
    <module>dispatcher</module>
  </modules>
</profile>