Ajout d’un pipeline hors production configuring-non-production-pipelines

Après avoir configuré un programme et créé au moins un environnement dans l’interface utilisateur de Cloud Manager, vous pouvez ajouter des pipelines hors production. Ces pipelines vous permettent de tester la qualité du code avant le déploiement dans les environnements de production.

Un utilisateur doit disposer du rôle Responsable de déploiement pour configurer des pipelines hors production.

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

Ajout d’un nouveau pipeline hors production adding-non-production-pipeline

Après avoir configuré un programme et créé au moins un environnement dans l’interface utilisateur de Cloud Manager, vous pouvez ajouter des pipelines hors production. Utilisez ces pipelines pour tester la qualité du code avant de le déployer dans des environnements de production.

Pour ajouter un nouveau pipeline hors production, procédez comme suit

  1. Connectez-vous à Cloud Manager sur experience.adobe.com.

  2. Dans la section Accès rapide, cliquez sur Experience Manager.

  3. Dans le panneau de gauche, cliquez sur Cloud Manager.

  4. Sélectionnez l’organisation de votre choix.

  5. Sur la console Mes programmes, cliquez sur un programme.

  6. Dans le panneau de gauche, cliquez sur Pipelines.

  7. Sur la page Pipelines, près du coin supérieur droit, cliquez sur Ajouter un pipeline > Ajouter un pipeline hors production.

    Ajouter un pipeline hors production

  8. Sous l’onglet Configuration de la boîte de dialogue Ajouter un pipeline hors production, sélectionnez l’un des pipelines hors production suivants que vous souhaitez créer :

    • Pipeline de qualité du code - Crée un pipeline qui génère le code sur une branche GIT, exécute des tests unitaires et évalue la qualité du code sans le déployer dans un environnement.
    • Pipeline de déploiement - Crée un pipeline qui génère le code, exécute des tests unitaires, évalue la qualité du code et le déploie dans un environnement hors production.

    Boîte de dialogue Ajouter un pipeline hors production

  9. Sous la section Configuration du pipeline, dans le champ Nom du pipeline hors production, saisissez une description de votre pipeline hors production.

  10. Sous la section Options de déploiement, sélectionnez l’un des déclencheurs de déploiement suivants que vous souhaitez utiliser :

    • Manuel : vous permet de lancer le pipeline manuellement.
    • Lors des modifications Git : démarre le pipeline 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.
  11. Sélectionnez le Comportement en cas d’échecs de mesure importants à utiliser.

    • 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 émule essentiellement un utilisateur rejetant 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 émule essentiellement la validation manuelle de chaque échec par un utilisateur.
  12. Cliquez sur Continuer.

  13. Les étapes restantes que vous utilisez pour terminer la configuration de votre pipeline hors production dépendent du type de code source que vous choisissez d’utiliser.
    Sous l’onglet Code de la boîte de dialogue Ajouter un pipeline hors production, sélectionnez le type de code que le pipeline hors production doit traiter.

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

J’utilise le code de pile complète. full-stack-code

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.

NOTE
Si un pipeline de code full stack existe 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 la section Code, définissez les options suivantes.

    • Environnements de déploiement éligibles - Disponible uniquement lorsque vous modifiez un pipeline hors production. Si votre pipeline est un pipeline de déploiement, vous devez sélectionner les environnements à déployer.

    • Référentiel - Dans la liste déroulante, sélectionnez le référentiel Git que le pipeline utilise comme source. Cloud Manager crée le code à partir du référentiel que vous choisissez ici.

      note tip
      TIP
      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 - Dans la liste déroulante, choisissez la branche du référentiel sélectionné à partir de laquelle le pipeline doit être créé. La valeur par défaut est main. Le pipeline utilise la branche choisie comme source pour la création et le déploiement. Si nécessaire, cliquez sur Actualiser pour mettre à jour la liste des branches disponibles pour le référentiel sélectionné. Utilisez cette option si une branche créée récemment n’apparaît pas dans la liste.

    • Créer une stratégie

      • Version complète - Génère tous les modules du référentiel à chaque fois

      • BETA Smart Build - crée uniquement les modules qui ont été modifiés depuis la dernière validation.
        En savoir plus sur l’utilisation de la création intelligente dans un pipeline hors production.

        note important
        IMPORTANT
        Le build intelligent est disponible uniquement pour les pipelines de qualité du code et de déploiement de code de pile complète de développement.
    • Case à cocher Ignorer la configuration de niveau web - Lorsque cette case est cochée, le pipeline ne déploie pas votre configuration de niveau web.

  2. Dans la section 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.

    Pipeline full stack

  3. Cliquez sur Enregistrer.

Le pipeline est enregistré et vous pouvez maintenant [gérer vos pipelines]​(managing-pipe
lines.md) sur la carte Pipelines sur la page Présentation du programme.

J’utilise le déploiement ciblé targeted-deployment

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 d’Inclure l’un des types de code suivants :

Options de déploiement ciblé

  • 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 de niveau web - Configurez les propriétés Dispatcher pour stocker, traiter et diffuser des pages web au client.

    • Voir le document Pipelines CI/CD pour plus d’informations.

    • Si un pipeline de code de niveau web existe pour l’environnement sélectionné, cette sélection est désactivée.

    • Si un pipeline full stack est déjà déployé vers un environnement, vous pouvez toujours créer un pipeline de configuration de niveau web pour ce même environnement. Dans ce cas, Cloud Manager ignore la configuration de la couche web dans le pipeline full stack.

      note note
      NOTE
      Les pipelines de niveau web et de configuration ne sont pas pris en charge pour les référentiels privés. Voir Ajout de référentiels privés dans Cloud Manager pour plus d’informations et la liste complète des limitations.
  1. Dans la section Code, définissez les options suivantes :

    • Référentiel - cette option définit à partir de quel référentiel GIT le pipeline hors production doit récupérer le code.

      note tip
      TIP
      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 du 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.

  2. Si vous avez activé le contrôle de l’expérience, cliquez sur Continuer pour accéder à l’onglet Contrôle de l’expérience où vous pouvez définir les chemins qui doivent toujours être inclus dans le contrôle de l’expérience.

    • Si vous avez activé contrôle de l’expérience, consultez le document contrôle de l’expérience pour plus d’informations sur la configuration.
    • Si ce n’est pas le cas, ignorez cette étape.
  3. Cliquez sur Enregistrer pour enregistrer le pipeline.

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

À propos de l’utilisation de la création dynamique dans un pipeline hors production about-smart-build-non-production-pipeline

La version intelligente dans Cloud Manager est une stratégie de création optimisée pour les pipelines hors production. La génération intelligente réduit les temps de génération en mettant en cache les modules et en ne reconstruisant que les modules qui ont été modifiés depuis la dernière exécution réussie. Les modules inchangés sont réutilisés à partir du cache, tandis que seuls les modules modifiés et leurs dépendances sont reconstruits, ce qui améliore l’efficacité des workflows de développement itératifs.

La génération intelligente n'est actuellement disponible que pour les éléments suivants :

  • Pipelines de la qualité du code.
  • Développez des pipelines de déploiement full stack.
NOTE
La première exécution après l’activation de la création dynamique se comporte comme une création complète, car le cache est vide.

Le build intelligent est recommandé lorsque vous disposez des éléments suivants :

  • Vous développez et validez activement des modifications incrémentielles fréquentes.
  • Votre projet contient plusieurs modules Maven.
  • Les versions complètes prennent beaucoup de temps.

La création intelligente n’est pas toujours idéale lorsque vous disposez des éléments suivants :

  • Votre version repose principalement sur des modules externes qui effectuent des opérations en dehors du graphique de dépendance de Maven.
  • Vous avez besoin d’une validation de reconstruction complète à chaque exécution.

Présentation des performances de build smart-build-performance

Le gain de performances de l’utilisation de la création dynamique dépend de plusieurs facteurs, notamment des éléments suivants :

  • Nombre de modules dans le projet.
  • La fréquence et l’étendue des modifications de code.
  • La distribution des dépendances entre les modules.

En règle générale, les projets comportant de nombreux modules indépendants peuvent bénéficier de la plus grande amélioration.

Désinscription du cache par module smart-build-cache-optout

Smart Build fournit un contrôle affiné qui vous permet de désactiver la mise en cache pour des modules spécifiques. Cette fonctionnalité est utile lorsque certains modules :

  • Utilisez des plug-ins, tels que exec-maven-plugin ou maven-antrun-plugin.
  • Effectuer des opérations de fichier non suivies par les dépendances Maven.
  • Le contenu mis en cache génère des résultats incohérents.

Désactiver la mise en cache pour un module smart-build-disable-caching

Vous pouvez ajouter la propriété suivante au pom.xml du module concerné :

<properties>
  <maven.build.cache.enabled>false</maven.build.cache.enabled>
</properties>

Cette syntaxe force le module à se recréer à chaque exécution de pipeline tandis que les autres modules continuent à bénéficier de la mise en cache.

Restrictions et considérations lors de l’utilisation de la création dynamique smart-build-limitations

Gardez les points suivants à l’esprit lorsque vous utilisez la création dynamique :

  • Smart Build repose sur l’analyse des dépendances Maven.
  • Les modifications en dehors du graphique de dépendance peuvent ne pas déclencher de reconstructions.
  • Certains plug-ins peuvent ne pas être entièrement compatibles avec la mise en cache.
  • Vous pouvez revenir à la version complète à tout moment en modifiant le pipeline hors production.

Si vous rencontrez un comportement de build inattendu, envisagez de désactiver la mise en cache de modules spécifiques ou de changer temporairement votre stratégie de build en Version complète.

Dépannage des problèmes de création dynamique smart-build-troubleshoot

Problème
Solutions suggérées
Les résultats de build sont incohérents
· Désactivez la mise en cache pour les modules concernés.
· Vérification du comportement des plug-ins (en particulier des plug-ins exec/antrun).
Aucune amélioration des performances
· Assurez-vous que plusieurs exécutions ont eu lieu (préchauffage du cache).
· Vérifiez si la plupart des modules changent fréquemment.
Artefacts inattendus ou modifications manquantes
· Vérifier si les modifications se situent en dehors du suivi des dépendances Maven.
· Utilisez Full Build pour la vérification.

Voir Ajouter un pipeline hors production pour activer la création intelligente.

Exclure les packages Dispatcher exclude-dispatcher-packages

Si vous souhaitez que les packages Dispatcher soient créés dans votre pipeline mais ne soient pas chargés pour créer du stockage, désactivez la publication. Cela peut raccourcir le temps d’exécution du pipeline.

Ajoutez la configuration suivante à votre fichier de pom.xml de projet pour désactiver la publication des packages Dispatcher. Définissez une variable d’environnement dans le conteneur de création Cloud Manager pour indiquer quand ignorer les packages Dispatcher. Le pipeline lit cet indicateur et l’ignore en conséquence.

<profile>
  <id>only-include-dispatcher-when-it-isnt-ignored</id>
  <activation>
    <property>
      <name>env.IGNORE_DISPATCHER_PACKAGES</name>
      <value>[!NOTE]rue</value>
    </property>
  </activation>
  <modules>
    <module>dispatcher</module>
  </modules>
</profile>
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab