Déployer 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 intermédiaire, 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 :

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.

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.

Déploiement de votre 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.

Le processus de création déploie votre code au cours des trois phases triées suivantes :

Phase de déploiement intermédiaire stage-deployment

La phase de déploiement dans l’environnement intermédiaire comprend les étapes suivantes :

Phase de test d’évaluation stage-testing

La phase Test d’évaluation comprend les étapes suivantes :

Phase de déploiement de la 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 d’un site AEM.

Les déploiements en production suivent généralement les mêmes étapes que précédemment décrites, mais de manière progressive. Ces étapes sont les suivantes :

Ce processus se poursuit jusqu’à ce que le déploiement ait atteint tous les éditeurs et dispatchers dans la topologie.

Délais d’expiration pendant un déploiement timeouts

Les étapes suivantes expirent si elles attendent les commentaires des utilisateurs lors d’un déploiement :

Réexécuter 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é des trois étapes suivantes :

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

Exécuter à nouveau 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 nouvelles exécutions.

Déclencher une nouvelle 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.

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. Ce workflow est similaire au démarrage d’une exécution régulière via l’API.

Identifier une exécution de nouvelle exécution identify-reexecution

Le système identifie les réexécutions en définissant le champ trigger sur la valeur RE_EXECUTE.