Configuration de 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.

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.
REMARQUE

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

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 Ajout d’un pipeline hors production.

    Ajouter un pipeline hors production

  3. Sur 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, soit un Pipeline de qualité du code ou un Pipeline de déploiement.

    Boîte de dialogue Ajouter un pipeline hors production

  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. Cliquez sur Continuer.

  6. 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.

Les étapes pour terminer la création de votre pipeline hors production varient en fonction de l’option que vous sélectionnez pour le Code source. Suivez les liens ci-dessus pour accéder à la section suivante de ce document afin de terminer la configuration de votre pipeline.

Code front-end

Un pipeline de code front-end déploie les versions de code front-end contenant une ou plusieurs applications d’interface utilisateur côté client. Consultez le document Pipelines CI/CD pour plus d’informations sur ce type de pipeline.

Pour terminer la configuration du pipeline hors production de code front-end, 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 le document Ajout et gestion des 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 sélectionnée le pipeline 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 trouvera les branches correspondantes pour vous aider à 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.

    Pipeline front-end

  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.

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. Consultez le document Pipelines CI/CD pour plus d’informations sur ce type de pipeline.

REMARQUE

Si un pipeline de code full stack existe déjà pour l’environnement sélectionné, cette sélection est désactivée.

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 le document Ajout et gestion des 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 sélectionnée le pipeline 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 trouvera les branches correspondantes pour vous aider à 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 full stack

  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.

Configuration de la couche web

Un pipeline de configuration de niveau web déploie les configurations HTTPD/Dispatcher. Consultez le document Pipelines CI/CD pour plus d’informations sur ce type de pipeline.

REMARQUE

Si un pipeline de code de la couche web existe déjà pour l’environnement sélectionné, cette sélection est désactivée.

Pour terminer la configuration du pipeline hors production de code de la couche web, 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 le document Ajout et gestion des 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 sélectionnée le pipeline doit récupérer le code.
    • 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.
      • Pour les pipelines de configuration de niveau web, il s’agit généralement du chemin contenant les répertoires conf.d, conf.dispatcher.d et opt-in.
      • Par exemple, si la structure du projet a été générée à partir de l’Archétype de projet AEM, le chemin serait /dispatcher/src.

    Pipeline de couche web

  2. Cliquez sur Enregistrer.

REMARQUE

Si vous disposez déjà d’un pipeline full stack se déployant vers un environnement, la création d’un pipeline de configuration de niveau web pour le même environnement entraîne l’exclusion de la configuration de niveau web existante dans le pipeline full stack.

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

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 de Dispatcher doit être ajoutée via votre fichier pom.xml de 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>

Sur cette page