Déploiement de votre code deploy-your-code
Découvrez comment déployer votre code vers la Production à l’aide des pipelines Cloud Manager dans AEM as a Cloud Service.
Le déploiement du code de manière transparente sur l’environnement d’évaluation, puis jusqu’à la production, est effectué via un pipeline de production. L’exécution du pipeline de production est divisée en deux phases logiques.
- Déploiement dans un environnement d’évaluation
- Le code est créé et déployé dans l’environnement d’évaluation pour les tests fonctionnels automatisés, les tests de l’interface utilisateur, le contrôle de l’expérience et les tests d’acceptation utilisateur (UAT).
- Déploiement dans un environnement de production
- Une fois que la version est validée à l’étape d’évaluation et approuvée pour le passage en production, le même artefact de build est déployé dans l’environnement de production.
Seul le type de pipeline Code full stack prend en charge l’analyse de code, les tests de fonction, les tests d’interface utilisateur et le contrôle de l’expérience.
Déploiement de code avec Cloud Manager dans AEM as a Cloud Service deploying-code-with-cloud-manager
Une fois que vous avez configuré votre pipeline de production, y compris le référentiel, l’environnement et l’environnement de test, vous êtes prêt à déployer votre code.
-
Connectez-vous à Cloud Manager à l’adresse my.cloudmanager.adobe.com et sélectionnez l’organisation appropriée.
-
Dans la console Mes programmes, appuyez ou cliquez sur le programme pour lequel vous souhaitez déployer du code.
-
Cliquez sur Déployer dans l’appel à l’action de l’écran Présentation pour lancer le processus de déploiement.
-
L’écran Exécution du pipeline s’affiche. Cliquez sur Générer pour lancer le processus.
Le processus de build déploie votre code en trois phases.
Phase de déploiement dans l’environnement stage-deployment
La phase de Déploiement dans l’environnement comprend ces étapes.
- Validation - Cette étape permet de s’assurer que le pipeline est configuré pour utiliser les ressources actuellement disponibles, par exemple, en s’assurant de l’existence de la branche configurée et de la disponibilité des environnements.
- Test unitaire et création - Cette étape exécute un processus de création en conteneur.
- Voir Détails de l’environnement de création pour plus d’informations sur l’environnement de création.
- Analyse du code - Cette étape évalue la qualité du code de votre application.
- Voir Test de qualité du code pour plus d’informations sur le processus de test.
- Images de build - Ce processus est responsable de la transformation du contenu et des packages du Dispatcher générés par l’étape de build en images Docker et en configuration Kubernetes.
- Déployer sur l’environnement d’évaluation : l’image est déployée dans l’environnement d’évaluation en vue de l’ étape de test d’évaluation.
Phase de test d’évaluation stage-testing
La phase de test d’évaluation comprend ces étapes.
-
Tests fonctionnels du produit - Le pipeline Cloud Manager exécute des tests qui s’exécutent sur l’environnement d’évaluation.
- Pour plus d’informations, voir Tests fonctionnels du produit.
-
Tests fonctionnels personnalisés - Cette étape du pipeline est toujours exécutée et ne peut pas être ignorée. Cependant, si aucun fichier JAR de test n’est généré par le build, le test réussit par défaut.
- Pour plus d’informations, voir Tests fonctionnels personnalisés.
-
Test d’interface utilisateur personnalisé - Cette étape est une fonctionnalité facultative qui exécute automatiquement des tests d’interface utilisateur créés pour des applications personnalisées.
- Les tests de l’interface utilisateur sont des tests basés sur Selenium placés dans une image Docker pour permettre un large choix de langues et de cadres (tels que Java et Maven, Node et WebDriver.io, ou tout autre cadre et technologie basés sur Selenium).
- Pour plus d’informations, voir Tests d’interface utilisateur personnalisés.
-
Contrôle de l’expérience - Cette étape du pipeline est toujours exécutée et ne peut pas être ignorée. Lorsqu’un pipeline de production est exécuté, une étape de contrôle de l’expérience est incluse après les tests fonctionnels personnalisés qui exécuteront les contrôles.
- Les pages configurées sont envoyées au service et évaluées.
- Les résultats sont informatifs et affichent les scores et le changement entre les scores actuels et précédents.
- Ces informations sont utiles pour déterminer si une régression est introduite avec le déploiement actuel.
- Pour plus d’informations, voir Compréhension des résultats de l’audit de l’expérience.
Phase de déploiement en production production-deployment
Le processus de déploiement des topologies de production diffère légèrement afin de minimiser l’impact sur les visiteurs et les visiteuses d’un site AEM.
Les déploiements en production suivent généralement les mêmes étapes décrites précédemment, mais par roulements.
- Déploiement des packages AEM sur l’instance de création.
- Détachement de dispatcher1 de l’équilibreur de charge.
- Déploiement des packages AEM sur publish1 et le package dispatcher sur dispatcher1. Purge du cache du dispatcher.
- Replacement du dispatcher1 dans l’équilibreur de charge.
- Lorsque dispatcher1 fonctionne à nouveau, détachement de dispatcher2 de l’équilibreur de charge.
- Déploiement des packages AEM sur publish2 et le package dispatcher sur dispatcher2. Purge du cache du dispatcher.
- Replacement du dispatcher2 dans l’équilibreur de charge.
Ce processus se poursuit jusqu’à ce que le déploiement ait atteint toutes les instances de publication et tous les Dispatchers dans la topologie.
Délais d’expiration timeouts
Les étapes suivantes expirent s’ils sont en attente de commentaires de l’utilisateur :
Processus de déploiement deployment-process
Tous les déploiements de Cloud Service suivent un processus continu pour garantir un temps d’arrêt nul. Pour en savoir plus, voir Fonctionnement des déploiements en continu.
Réexécution d’un déploiement en production reexecute-deployment
Dans de rares cas, les étapes de déploiement en production peuvent échouer pour des raisons transitoires. Dans ce cas, la réexécution de l’étape de déploiement en production est prise en charge tant que l’étape de déploiement en production est terminée, quel que soit le type d’achèvement (par exemple, annulé ou non). La réexécution crée une nouvelle exécution à l’aide du même pipeline constitué de trois étapes.
- L’étape de validation : il s’agit essentiellement de la même validation qui se produit lors de l’exécution normale d’un pipeline.
- L’étape de création : dans le contexte d’une réexécution, l’étape de création copie les artefacts et n’exécute pas de nouveau processus de création.
- L’étape de déploiement en production : utilise la même configuration et les mêmes options que l’étape de déploiement en production dans une exécution normale de pipeline.
Dans de telles circonstances, si une réexécution est possible, la page de statut du pipeline de production fournit l’option Réexécuter en regard de l’option habituelle Télécharger le journal de création.
Limites limitations
- La réexécution de l’étape de déploiement en production n’est disponible que pour la dernière exécution.
- La réexécution n’est pas disponible pour les exécutions de mise à jour push.
- Si la dernière exécution est une exécution de mise à jour push, la réexécution n’est pas possible.
- Si la dernière exécution a échoué à un moment donné avant l’étape de déploiement en production, la réexécution n’est pas possible.
Réexécution de l’API reexecute-API
En plus d’être disponible dans l’IU, l’API Cloud Manager peut servir à déclencher de nouvelles exécutions et à identifier les exécutions déclenchées comme réexécutions.
Déclencher une réexécution reexecute-deployment-api
Pour déclencher une réexécution, envoyez une requête de PUT au lien HAL https://ns.adobe.com/adobecloud/rel/pipeline/reExecute sur l’état de l’étape de déploiement de production.
- Si ce lien est présent, l’exécution peut être redémarrée à partir de cette étape.
- En cas d’absence, l’exécution ne peut pas être redémarrée à partir de cette étape.
Ce lien n’est disponible que pour l’étape de déploiement en production.
{
"_links": {
"https://ns.adobe.com/adobecloud/rel/pipeline/logs": {
"href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/logs",
"templated": false
},
"https://ns.adobe.com/adobecloud/rel/pipeline/reExecute": {
"href": "/api/program/4/pipeline/1/execution?stepId=2983530",
"templated": false
},
"https://ns.adobe.com/adobecloud/rel/pipeline/metrics": {
"href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530/metrics",
"templated": false
},
"self": {
"href": "/api/program/4/pipeline/1/execution/953671/phase/1575676/step/2983530",
"templated": false
}
},
"id": "6187842",
"stepId": "2983530",
"phaseId": "1575676",
"action": "deploy",
"environment": "weretail-global-b75-prod",
"environmentType": "prod",
"environmentId": "59254",
"startedAt": "2022-01-20T14:47:41.247+0000",
"finishedAt": "2022-01-20T15:06:19.885+0000",
"updatedAt": "2022-01-20T15:06:20.803+0000",
"details": {
},
"status": "FINISHED"
La syntaxe de la valeur href du lien HAL n’est qu’un exemple. La valeur réelle doit toujours être lue à partir du lien HAL et non générée.
L’envoi d’une requête de PUT à ce point de terminaison entraîne une réponse 201 en cas de réussite, et le corps de la réponse est la représentation de la nouvelle exécution. Cela revient à lancer une exécution régulière via l’API.
Identification d’une exécution réexécutée identify-reexecution
Les exécutions réexécutées peuvent être identifiées par la valeur RE_EXECUTE dans le champ trigger.