DocumentationExperience Cloud KCS

AEM Cloud Manager : échec du pipeline de pile complète à « Déployer vers l’environnement de développement » en raison d’un XML DocView malformé dans le package de contenu

Dernière mise à jour : 29 juin 2026

Cet article traite des échecs constants dans le pipeline de pile complète du cloud Adobe Experience Manager pendant l’étape « Déployer vers l’environnement de développement », causés par un XML DocView malformé dans un package de contenu.

Description description

Environnement

Adobe Experience Manager (AEM) as a Cloud Service (toutes les versions)

Problème/Symptômes

Le pipeline de pile pleine dans le cloud échoue de manière cohérente lors de l’étape Déployer vers l’environnement de développement. Plusieurs exécutions de pipeline présentent le même comportement, le processus de déploiement échouant ou restant bloqué pendant des périodes prolongées (par exemple, plus de 1,5 heure) sans progresser. Aucune information d’erreur exploitable n’est visible dans les journaux de déploiement.

  • Le problème est reproductible en déclenchant le pipeline de pile complète pour l’environnement affecté.
  • Aucun message d’erreur spécifique ne s’affiche dans les journaux ; le pipeline semble se bloquer ou échouer silencieusement à l’étape de déploiement.

Résolution resolution

  1. Identifier le package de contenu problématique

    • Examinez les packages de contenu inclus dans le pipeline, en vous concentrant sur les packages récemment ajoutés ou modifiés.
    • Recherchez les packages générés par des outils automatisés qui peuvent introduire un code XML malformé.

  2. Valider les fichiers XML DocView

    • Extrayez le package de contenu et recherchez tous les fichiers .content.xml.
    • Utilisez un outil de validation XML tel que xmllint pour vérifier le format de chaque fichier .content.xml.
    code language-none 
    find . -name '*.content.xml' -exec xmllint --noout {} \;
    • Traitez toutes les erreurs de syntaxe XML signalées par le programme de validation.

  3. Mettre à jour le processus de génération pour éviter des problèmes futurs

    • Assurez-vous que le module ui.content est créé à l’aide du plug-in Maven FileVault Package.
    • Exécutez mvn clean verify pour valider la structure du package et l’exactitude XML avant de valider ou de déployer.
    • Référence : Structure De Package De Contenu De Projet ​

  4. Ajouter la validation XML au pipeline CI

    • Intégrer une étape de validation XML dans le processus CI pour vérifier automatiquement le bon format de tous les fichiers .content.xml avant le déploiement.

  5. Réexécuter le pipeline

    • Après avoir corrigé tout code XML incorrect et mis à jour le processus de création, redéclenchez le pipeline pour vérifier que le déploiement a réussi.

Cause

Les échecs de pipeline étaient dus à un fichier XML DocView incorrect dans un package de contenu modifiable. Ce problème n’est apparu que lorsque le package problématique a été traité lors de l’étape de déploiement, et non en raison de modifications apportées à l’analyseur d’Adobe ou à l’outil de plug-in.

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