Die Cloud Manager-Pipeline wird angehalten und schlägt fehl, wenn der Vorschau-Dispatcher nicht bereit ist
In diesem Artikel wird erläutert, wie Sie AEM as a Cloud Service-Bereitstellungs-Pipelines beheben können, die stundenlang im Startstatus bleiben und dann fehlschlagen, wenn der Vorschau-Dispatcher nicht rechtzeitig bereit ist.
Beschreibung description
Umgebung
- Adobe Experience Manager (AEM) as a Cloud Service
- Cloud Manager-Bereitstellungs-Pipelines unter Verwendung von Dispatcher-Konfigurationen mit verwalteten Rewrite-Zuordnungen
Problem/Symptome
- Die Bereitstellungs-Pipeline verbleibt für einen längeren Zeitraum im Start- oder Aufwärmzustand, bevor sie fehlschlägt.
- Die Fehler bei den Dispatcher-Start- und Bereitschaftsprüfungen werden in den Protokollen zu
content/dam/rewrites/redirectsangezeigt. - Cloud Manager zeigt nach langer Verzögerung eine allgemeine Fehlermeldung zu Bereitstellungsfehlern an.
The deployment failed due to a system issue. Contact Adobe Support if the issue recurs.
- Die Build- und Code-Qualitätsschritte wurden erfolgreich abgeschlossen, aber die Bereitstellung schreitet danach nicht normal voran.
- Das Problem kann auch auftreten, wenn dieselbe Verzweigung oder derselbe Code in vorherigen Ausführungen erfolgreich bereitgestellt wurde.
- Dies ist wahrscheinlicher, wenn das Projekt verwaltete Rewrite-Zuordnungen verwendet und sich der Start des Dispatchers in der Vorschau verzögert.
Reproduktionsbedingungen
- Es wird versucht, Code (sogar zuvor erfolgreichen Code) mithilfe von Cloud Manager in der Entwicklungsumgebung bereitzustellen.
- Der Vorschau-Dispatcher oder die zugehörigen Vorschau-Services werden innerhalb des erwarteten Zeitraums nicht fehlerfrei.
- Die Pipeline schlägt nach langer Wartezeit fehl oder wird erfolgreich abgeschlossen, jedoch mit einer ungewöhnlich langen Laufzeit.
Ursache
Die Bereitstellungs-Pipeline bleibt hängen und schlägt schließlich fehl, da der Vorschau-Dispatcher-Container nicht den Status Bereit erreicht, was dazu führt, dass Cloud Manager wartet, bis eine Zeitüberschreitung auftritt. Wenn Sie die Dispatcher-YAML-Konfiguration aktualisieren, um das Warte-Flag auf „false“ festzulegen, kann der Vorschau-Dispatcher gestartet werden, ohne die Pipeline zu blockieren.
Lösung resolution
Gehen Sie wie folgt vor, um Pipeline-Verzögerungen und -Fehler zu beheben, die durch die Blockierung des Vorschau-Dispatcher-Starts bei verwalteten Rewrite-Zuordnungen verursacht werden:
- Vergewissern Sie sich, dass alle Vorschau-Services, einschließlich des Dispatchers, korrekt konfiguriert sind und ohne Fehler gestartet werden können. Überprüfen Sie die Cloud Manager-Protokolle auf Fehler bei Bereitschafts- oder Konsistenzprüfungen im Zusammenhang mit der Dispatcher-Vorschau.
- Bearbeiten Sie die YAML-Datei der Dispatcher-Konfiguration, z. B.
rewrite-maps.yamlodermanaged-rewrite-maps.yaml. Überprüfen Sie die Datei auf Zuordnungseinträge, die den Start blockieren können, und stellen Sie sicher, dass daswait-Flag für alle Zuordnungseinträge auffalsegesetzt ist. Beispiel:
maps:
- name: redirects-301.map
path: /content/dam/rewrites/redirects-301.txt
ttl: 300
wait: false
- name: redirects-302.map
path: /content/dam/rewrites/redirects-302.txt
ttl: 300
wait: false
- Speichern und übertragen Sie die Änderungen in Ihrem Repository und führen Sie dann die Pipeline in Cloud Manager erneut aus.
- Überwachen Sie die Pipeline-Ausführung, um zu bestätigen, dass der Vorschau-Dispatcher und die zugehörigen Services rechtzeitig einen ordnungsgemäßen Status erreichen, anstatt sich in einem längeren Start- oder Aufwärmzustand zu befinden.
- Stellen Sie nach einer erfolgreichen Bereitstellung sicher, dass der Dispatcher-Code erwartungsgemäß bereitgestellt wurde.
- Wenn die Pipeline weiterhin länger dauert als erwartet oder fehlschlägt, überprüfen Sie die Dispatcher- und Vorschau-Service-Protokolle auf zusätzliche Bereitschafts-, Konsistenzprüfungs- oder Startprobleme.