DocumentationExperience Cloud KCS

Pipeline de déploiement AEM Cloud Manager bloqué pendant le déploiement

Dernière mise à jour : 30 septembre 2026

Cet article explique comment résoudre les problèmes liés à un pipeline de déploiement Adobe Experience Manager (AEM) as a Cloud Service qui reste en cours d’exécution ou bloqué pendant la création ou le déploiement. Les journaux peuvent identifier des définitions d’index Oak non valides, des échecs de validation de package FileVault, des erreurs de code personnalisé ou des problèmes de préparation du conteneur de publication. Pour résoudre ce problème, examinez le pipeline et les journaux de déploiement, corrigez le code ou la configuration lorsque les journaux identifient un problème client, validez le package localement, réexécutez le pipeline et vérifiez que l’environnement et les capsules sont sains.

Description description

Environnement

  • Adobe Experience Manager as a Cloud Service
  • Adobe Experience Manager Cloud Manager
  • Pipeline de déploiement Cloud Manager
  • Définitions de packages d’index Oak et FileVault personnalisés dans la base de code du projet
  • Environnement de publication faisant l’objet de déploiements et de contrôles de préparation

Problème/Symptômes

  • Lorsque vous exécutez un déploiement Cloud Manager, le pipeline reste en cours d’exécution pendant la création ou le déploiement dans l’environnement intermédiaire et ne progresse pas.
  • Le pipeline bloqué empêche l’activité de publication et la promotion vers des environnements supérieurs.
  • Les journaux de build contiennent des erreurs telles que ValidationViolation : nœud enfant obligatoire manquant ou des erreurs de type de nœud non valide dans les fichiers de configuration.
  • Les conteneurs de publication démarrent mais ne sont pas prêts, de sorte que l’environnement n’atteint pas l’état de préparation requis.

Cause

Le pipeline ne progresse pas lorsque la validation de la version ou du déploiement rejette une définition d’index Oak non valide, un nœud enfant obligatoire manquant ou un type de nœud non valide dans un package FileVault. Une autre condition de préparation au déploiement se produit lorsque les conteneurs de publication démarrent mais ne sont pas prêts, de sorte que Cloud Manager ne peut pas marquer l’environnement comme prêt. La cause pertinente est déterminée à partir du pipeline et des journaux de déploiement.

Résolution resolution

Suivez les étapes ci-dessous pour résoudre le problème :

  1. Consultez les détails d’exécution du pipeline Cloud Manager pour l’exécution concernée.

  2. Téléchargez et examinez les journaux de version et de déploiement, en vous concentrant sur les étapes de création et de déploiement.

  3. Recherchez les erreurs de validation de package d’index Oak ou FileVault, telles que :

    • ValidationViolation : nœud enfant obligatoire manquant
    • Erreurs de type de nœud non valides dans les fichiers de configuration, tels que src/main/content/jcr_root/_oak_index/your-index-name/config.xml.

  4. Mettez à jour les fichiers de configuration d’index Oak dans la base de code de votre projet afin qu’ils soient conformes aux règles d’indexation AEM as a Cloud Service et aux types de nœuds JCR/Oak. Remarque : déployez les définitions d’index Oak sous forme de code via Cloud Manager. Ne modifiez pas manuellement les nœuds d’index d’exécution dans un environnement en cours d’exécution.

  5. Exécutez localement le programme de validation de packages FileVault sur votre package avant de valider les modifications. Vérifiez que les définitions de package sont validées.

  6. Après avoir corrigé les problèmes de configuration, lancez une nouvelle exécution de pipeline dans Cloud Manager.

  7. Surveillez le pipeline et vérifiez qu’il progresse au-delà de l’étape précédemment bloquée.

  8. Si le niveau de publication reste sur En cours avec des conteneurs non prêts :

    • Consultez les journaux de déploiement pour détecter les erreurs de démarrage du conteneur.
    • Corrigez les erreurs d’exécution ou les configurations incorrectes identifiées dans les journaux.

    Remarque : si les journaux n’identifient pas de code client ou de problème de configuration et que les conteneurs ne sont pas prêts, collectez les journaux de déploiement et Cloud Manager et contactez l’assistance Adobe. N’essayez pas de gérer directement les capsules AEM.

  9. Vérifiez que le pipeline de déploiement s’est terminé correctement et que tous les pods sont signalés comme sains dans Cloud Manager.

recommendation-more-help
experience-cloud-kcs-help-kbarticles