AEM Cloud Manager-Bereitstellungs-Pipeline bleibt während der Bereitstellung hängen
In diesem Artikel wird erläutert, wie Sie Probleme mit einer Adobe Experience Manager (AEM) as a Cloud Service-Bereitstellungs-Pipeline beheben können, die während der Erstellung oder Bereitstellung in einem ausgeführten oder blockierten Status verbleibt. Die Protokolle können ungültige Oak-Indexdefinitionen, FileVault-Paketvalidierungsfehler, Fehler mit benutzerdefiniertem Code oder Probleme mit der Bereitschaft für den Veröffentlichungs-Container identifizieren. Um das Problem zu beheben, überprüfen Sie die Pipeline- und Bereitstellungsprotokolle, korrigieren Sie den Code oder die Konfiguration, wenn die Protokolle ein Kundenproblem identifizieren, validieren Sie das Paket lokal, führen Sie die Pipeline erneut aus und überprüfen Sie, ob die Umgebung und die Pods in Ordnung sind.
Beschreibung description
Umgebung
- Adobe Experience Manager as a Cloud Service
- Adobe Experience Manager Cloud Manager
- Cloud Manager-Bereitstellungs-Pipeline
- Benutzerdefinierte Oak-Index- und FileVault-Paketdefinitionen in der Projekt-Code-Basis
- Veröffentlichungsumgebung, die Bereitstellungs- und Bereitschaftsprüfungen durchläuft
Problem/Symptome
- Wenn Sie eine Cloud Manager-Bereitstellung ausführen, verbleibt die Pipeline während der Erstellung oder Bereitstellung im Staging in einem ausgeführten Status und wird nicht ausgeführt.
- Die blockierte Pipeline verhindert Versionsaktivitäten und die Promotion zu höheren Umgebungen.
- Build-Protokolle enthalten Fehler wie ValidationViolation: Obligatorischer untergeordneter Knoten fehlt oder ungültige Knotentyp-Fehler in Konfigurationsdateien.
- Veröffentlichungs-Container beginnen, werden aber nicht bereit, sodass die Umgebung den erforderlichen Bereitschaftsstatus nicht erreicht.
Ursache
Die Pipeline wird nicht fortgesetzt, wenn bei der Build- oder Bereitstellungsvalidierung eine ungültige Oak-Indexdefinition, ein fehlender obligatorischer untergeordneter Knoten oder ein ungültiger Knotentyp in einem FileVault-Paket zurückgewiesen wird. Eine separate Bereitstellungsbedingung tritt auf, wenn Veröffentlichungs-Container gestartet werden, aber nicht bereit werden, sodass Cloud Manager die Umgebung nicht als bereit markieren kann. Die relevante Ursache wird aus den Pipeline- und Bereitstellungsprotokollen ermittelt.
Lösung resolution
Gehen Sie wie folgt vor, um das Problem zu beheben:
-
Überprüfen Sie die Ausführungsdetails der Cloud Manager-Pipeline für die betroffene Ausführung.
-
Laden Sie die Build- und Bereitstellungsprotokolle herunter und überprüfen Sie sie, wobei Sie sich auf die Schritte Erstellen und Bereitstellen konzentrieren.
-
Suchen Sie nach Oak-Index- oder FileVault-Paketvalidierungsfehlern, z. B.:
- ValidationViolation: Obligatorischer untergeordneter Knoten fehlt
- Fehler mit ungültigem Knotentyp in Konfigurationsdateien wie
src/main/content/jcr_root/_oak_index/your-index-name/config.xml.
-
Aktualisieren Sie die Oak-Indexkonfigurationsdateien in Ihrer Projekt-Codebasis, damit sie den AEM as a Cloud Service-Indizierungsregeln und JCR/Oak-Knotentypen entsprechen. Hinweis: Bereitstellen von Oak-Indexdefinitionen als Code über Cloud Manager. Ändern Sie keine Laufzeitindexknoten in einer laufenden Umgebung manuell.
-
Führen Sie den FileVault Package Validator lokal für Ihr Paket aus, bevor Sie die Änderungen übernehmen. Bestätigen Sie, dass die Validierung der Paketdefinitionen erfolgreich ist.
-
Starten Sie nach der Korrektur der Konfigurationsprobleme eine neue Pipeline-Ausführung in Cloud Manager.
-
Überwachen Sie die Pipeline und bestätigen Sie, dass sie über den zuvor blockierten Schritt hinausgeht.
-
Wenn die Veröffentlichungsebene in Bearbeitung bleibt und Container nicht bereit sind:
- Überprüfen Sie die Bereitstellungsprotokolle auf Container-Startfehler.
- Beheben Sie die in den Protokollen identifizierten Laufzeitfehler oder Fehlkonfigurationen.
Hinweis: Wenn in den Protokollen kein Kunden-Code- oder Konfigurationsproblem identifiziert wird und die Container noch nicht bereit sind, erfassen Sie die Cloud Manager- und Bereitstellungsprotokolle und wenden Sie sich an den Adobe-Support. Versuchen Sie nicht, die AEM-Pods direkt zu verwalten.
-
Vergewissern Sie sich, dass die Bereitstellungs-Pipeline erfolgreich abgeschlossen wurde und alle Pods in Cloud Manager als fehlerfrei gemeldet werden.