Ajout d’un pipeline hors production configuring-non-production-pipelines
Découvrez comment utiliser Cloud Manager pour créer et configurer des pipelines hors production 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 Pipelines dans Cloud Manager, le Responsable de déploiement peut 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 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 hors production. Pour plus de détails sur la configuration des pipelines de production, voir le document Configurer des pipelines de production.
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, identiques à celles des pipelines de qualité du code, ces pipelines déploient le code dans un environnement hors production.
Ajout d’un nouveau pipeline hors production add-non-production-pipeline
Après avoir configuré un programme et 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é de votre code avant de le déployer dans des environnements de production.
-
Connectez-vous à Cloud Manager à l’adresse my.cloudmanager.adobe.com et sélectionnez l’organisation et le programme appropriés.
-
Sur l’écran d’accueil de Cloud Manager, ouvrez la carte Pipelines et cliquez sur Ajouter, puis sélectionnez Ajouter un pipeline hors production.
-
Sous l’onglet Configuration de la boîte de dialogue Ajouter un pipeline hors production, sélectionnez le type de pipeline que vous souhaitez créer, l’un des éléments suivants :
- Pipeline de qualité du code - Crée un pipeline qui génère le code, 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.
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 | ||
|---|---|---|
| Section | Option | Description |
| Configuration du pipeline | Nom du pipeline hors production | Saisissez une description pour votre pipeline dans le champ Nom du pipeline hors production. |
| Test |
Visible uniquement lors de la modification d’un pipeline hors production.
|
|
| Options de déploiement | Déclencheur de déploiement |
|
| Comportement en cas d’échecs de mesures importants |
|
|
| Case à cocher Approuver après le déploiement dans l’environnement intermédiaire | Visible uniquement lors de la modification d’un pipeline hors production. Sélectionnez cette option pour exiger une approbation après le déploiement dans l’environnement d’évaluation avant que le pipeline puisse continuer. Si cette option n’est pas sélectionnée, le pipeline se poursuit en fonction du comportement configuré. |
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 | ||
|---|---|---|
| Section | Option | Description |
| Configuration du pipeline | Nom du pipeline hors production | Saisissez une description pour votre pipeline dans le champ Nom du pipeline hors production. |
| Environnement de déploiement éligible | Si votre pipeline est un pipeline de déploiement, vous devez sélectionner les environnements dans lesquels Cloud Manager déploie le code. | |
| Test |
Visible uniquement lors de la modification d’un pipeline hors production.
|
|
| Options de déploiement | Déclencheur de déploiement |
|
| Comportement en cas d’échecs de mesures importants |
|
|
| Case à cocher Approuver après le déploiement dans l’environnement intermédiaire | Visible uniquement lors de la modification d’un pipeline hors production. Sélectionnez cette option pour exiger une approbation après le déploiement dans l’environnement d’évaluation avant que le pipeline puisse continuer. Si cette option n’est pas sélectionnée, le pipeline se poursuit en fonction du comportement configuré. |
|
| Case Ignorer les modifications de la répartition de charge | Sélectionnez cette option pour empêcher le pipeline d’effectuer des modifications de la répartition de charge pendant le déploiement. | |
| Configuration |
Le rôle Responsable de déploiement permet de 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é. Cloud Manager exécute ces actions de cache 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 standard d’AEM Dispatcher. Pour configurer
|
|
| Pipeline | Case à cocher Contrôle de l’expérience | Sélectionnez cette option pour inclure une étape de contrôle de l’expérience dans le pipeline. Lorsqu’il est activé, le pipeline inclut l’étape Contrôle de l’expérience après l’onglet Code Source . |
- Dans le coin inférieur droit de la boîte de dialogue Ajouter un pipeline hors production, cliquez sur Continuer.
- Sélectionnez le type de code que le pipeline est configuré pour créer et déployer.
Déploie l’ensemble de l’application AEM, y compris le code de l’application et, par défaut, la configuration de niveau web.
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 | ||
|---|---|---|
| Section | Option | Description |
| Code | Référentiel | Dans la liste déroulante , choisissez 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. |
| 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 |
|
|
| Case à cocher Ignorer la configuration de niveau web | Sélectionnez cette option pour ignorer le déploiement de la configuration de niveau web dans un pipeline de code de pile complète. Laissez l’option désélectionnée pour déployer la configuration de niveau web avec le code du pipeline. | |
| Pipeline | Case à cocher Contrôle de l’expérience | Sélectionnez cette option pour inclure une étape de contrôle de l’expérience dans le pipeline. Lorsqu’il est activé, le pipeline inclut l’étape Contrôle de l’expérience après l’onglet Code Source . |
Déploie uniquement la configuration de niveau web, telle que les propriétés Dispatcher utilisées pour stocker, traiter et diffuser des pages web au client. Lorsque vous sélectionnez Configuration de niveau web, Cloud Manager crée un pipeline dédié au déploiement de la configuration de niveau web.
Si un pipeline de pile complète existe déjà, Cloud Manager affiche un avis indiquant que la création d’un pipeline de configuration de niveau web entraîne l’exclusion de la configuration de niveau web par le pipeline de pile complète existant. Une fois que vous avez créé le pipeline de configuration de niveau web, Cloud Manager gère les déploiements de configuration de niveau web via ce pipeline au lieu du pipeline de pile complète.
| table 0-row-3 1-row-3 2-row-3 3-row-3 | ||
|---|---|---|
| Section | Option | Description |
| Code | Référentiel | Dans la liste déroulante, sélectionnez le référentiel Git contenant la configuration de niveau web. |
| Branche Git | Sélectionnez la branche dans le référentiel choisi que Cloud Manager utilise pour 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. | |
| Emplacement du code | Saisissez le chemin d’accès dans le référentiel sélectionné qui contient la configuration de niveau web à déployer. L’emplacement par défaut est la racine du référentiel (/). |
- Cliquez sur Enregistrer.
À propos de l’utilisation de la création dynamique dans un pipeline hors production about-smart-build
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.
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-pluginoumaven-antrun-plugin. - Effectuer des opérations de fichier non suivies par les dépendances Maven.
- Produire des résultats incohérents lors de la mise en cache.
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
· Vérifiez le comportement des plug-ins (en particulier des plug-ins
exec/antrun).· Vérifiez si la plupart des modules changent fréquemment.
· Utilisez Version complète pour la vérification.
Voir Ajouter un pipeline hors production la section Activation de la création dynamique.
Étapes suivantes the-next-steps
Après avoir configuré le pipeline, vous pouvez déployer votre code. Voir la section Déploiement du code pour plus d’informations.
Tutoriel vidéo video-tutorial
Cette vidéo présente une vue d’ensemble du processus de création de pipeline, détaillé dans ce document.