DokumentationExperience Cloud KCS

AEM Cloud Manager: Full-Stack-Pipeline schlägt bei „Für Entwicklung bereitstellen“ fehl aufgrund von fehlerhafter DocView-XML im Inhaltspaket

Letzte Aktualisierung: 6. Juli 2026

Dieser Artikel behandelt konsistente Fehler in der Adobe Experience Manager Cloud Full Stack Pipeline während des Schritts „Bereitstellung für Entwicklung“, die durch eine fehlerhafte DocView XML in einem Inhaltspaket verursacht wurden.

Beschreibung description

Umgebung

Adobe Experience Manager (AEM) as a Cloud Service (alle Versionen)

Problem/Symptome

Die Cloud-Full-Stack-Pipeline schlägt während der Phase Bereitstellung für Entwicklung konsequent fehl. Mehrere Pipeline-Ausführungen weisen das gleiche Verhalten auf, wobei der Bereitstellungsprozess entweder fehlschlägt oder über längere Zeiträume (z. B. über 1,5 Stunden) blockiert bleibt, ohne fortzufahren. In den Bereitstellungsprotokollen sind keine verwertbaren Fehlerinformationen sichtbar.

  • Das Problem ist reproduzierbar, indem die Full-Stack-Pipeline für die betroffene Umgebung ausgelöst wird.
  • In den Protokollen werden keine spezifischen Fehlermeldungen angezeigt. Die Pipeline scheint beim Bereitstellungsschritt zu hängen oder schlägt still fehl.

Lösung resolution

  1. Identifizieren des problematischen Inhaltspakets

    • Überprüfen Sie die in der Pipeline enthaltenen Inhaltspakete, wobei Sie sich auf kürzlich hinzugefügte oder geänderte Pakete konzentrieren.
    • Prüfen Sie, ob Pakete von automatisierten Tools generiert wurden, die fehlerhafte XML-Daten einführen können.

  2. Validieren von DocView XML-Dateien

    • Extrahieren Sie das Inhaltspaket und suchen Sie alle .content.xml.
    • Verwenden Sie ein XML-Validierungstool, z. B. xmllint, um jede .content.xml auf ihre korrekte Form zu überprüfen.
    code language-none 
    find . -name '*.content.xml' -exec xmllint --noout {} \;
    • Beheben Sie alle vom Validator gemeldeten XML-Syntaxfehler.

  3. Aktualisieren Sie den Build-Prozess, um zukünftige Probleme zu vermeiden

    • Stellen Sie sicher, dass das ui.content-Modul mit dem FileVault Package Maven-Plug-in erstellt wird.
    • Führen Sie mvn clean verify aus, um die Paketstruktur und die XML-Korrektheit vor der Übertragung oder Bereitstellung zu überprüfen.
    • Referenz: Inhaltspaketstruktur des AEM-Projekts

  4. Hinzufügen einer XML-Validierung zur CI-Pipeline

    • Integrieren Sie einen XML-Validierungsschritt in den CI-Prozess, um alle .content.xml-Dateien vor der Bereitstellung automatisch auf ihre korrekte Form zu überprüfen.

  5. Pipeline erneut ausführen

    • Nachdem Sie falsch formatierte XML korrigiert und den Build-Prozess aktualisiert haben, führen Sie einen erneuten Trigger der Pipeline aus, um eine erfolgreiche Bereitstellung zu überprüfen.

Ursache

Die Pipeline-Fehler wurden durch eine fehlerhafte DocView-XML-Datei in einem veränderlichen Inhaltspaket verursacht. Dieses Problem trat nur auf, wenn das problematische Paket während des Bereitstellungsschritts verarbeitet wurde, nicht aufgrund von Änderungen an den Analyzer- oder Plug-in-Tools von Adobe.

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