Dokumentation Commerce Commerce-Wissensdatenbank

Fehlerbehebung bei der Adobe Commerce-Bereitstellung

Letzte Aktualisierung: 5. Mai 2025

Erstellt für:

Entwickler

Festsitzende Bereitstellungen und fehlgeschlagene Bereitstellungen auf Adobe Commerce können mit dem Tool zur Bereitstellungs-Fehlerbehebung behoben werden. Klicken Sie auf die einzelnen Fragen, um die Antwort in jedem Schritt der Fehlerbehebung anzuzeigen.

Schritt 1: Überprüfen, ob der Dienst ausgeführt wird

Ist Adobe Commerce auf Cloud-Infrastruktur-Service aktiv?

Stack Deployment - Ist Adobe Commerce auf Cloud-Infrastruktur-Service aktiv? Überprüfen Sie Adobe Commerce Cloud.

a. JA - Mit Schritt 2 fortfahren.
b. NEIN - Wartung oder globale Ausfälle. Prüfen Sie auf geschätzte Dauer und Aktualisierungen.

Schritt 2: Überprüfen Sie Bereitstellungen in anderen Umgebungen.

Gibt es Bereitstellungen in anderen Umgebungen, die die Bereitstellung in der vorhandenen Umgebung blockieren?

Um eine Liste der laufenden Aktivitäten zu erhalten, führen Sie den folgenden Befehl mithilfe der Magento-Cloud-CLI aus (wenn Sie nur zu einem Cloud-Projekt hinzugefügt wurden). Hinweis: Vergewissern Sie sich, dass Sie die neueste Version von magento-cloud CLI verwenden. Anweisungen hierzu finden Sie unter Aktualisieren der CLI im Handbuch Commerce on Cloud Infrastructure .

magento-cloud --state=in_progress

Um eine Liste der laufenden Aktivitäten zu erhalten, führen Sie den folgenden Befehl mithilfe der Magento-Cloud-CLI aus (wenn Sie mehreren Projekten hinzugefügt wurden):

magento-cloud -p <project-id or project-url> --state=in_progress

Informationen zu einer vorhandenen Bereitstellungsaktivität finden Sie unter Überprüfen des Bereitstellungsprotokolls, wenn in der Cloud-Benutzeroberfläche der Fehler „Protokoll abgeschnitten“ auftritt
(für Details) Sie können diesen Befehl ausführen, um ein ausführendes Protokoll dieser Aktivität abzurufen:

magento-cloud activity:log <activity-id> [OPTIONAL: <-p project-id or project-url>]

a. JA - Fehlerbehebung bei Problemen mit der anderen Umgebung, die die Bereitstellung in der vorhandenen Umgebung blockiert. Fahren Sie mit Schritt 3 fort.

b. NEIN - Fehlerbehebung in der aktuellen Umgebung. Fahren Sie mit Schritt 3 fort.

Schritt 3: Überprüfen von SSH auf allen Knoten

SSH erfolgreich auf allen Knoten?

a. JA - Mit Schritt 4 fortfahren.
b. NEIN - Support-Ticket einreichen.

Schritt 4: Überprüfen aller laufenden Dienste

Alle Dienste werden ausgeführt?

a. JA - Mit Schritt 5 fortfahren.
b. NEIN - Support-Ticket einreichen.

Schritt 5: Bitbucket-Ausführung überprüfen

Mit Bitbucket?

a. JA - Überprüfen Sie status.bitbucket.com.
b. NEIN - Überprüfen Sie die Bereitstellungsprotokollfehler in den Build- und Bereitstellungsprotokollen. Fahren Sie mit Schritt 6 fort.

Schritt 6: Fehlercodes überprüfen

Fehlercode gemeldet?

a. JA - Mit Schritt 7 fortfahren.
b. NEIN - Fahren Sie mit Schritt 8 fort.

Schritt 7: 403 Fehler „Forbidden“

403 verboten?

a. JA - Mit Schritt 16 fortfahren.
b. NEIN - Fahren Sie mit Schritt 9 fort.

Schritt 8: Überprüfen der laufenden Cron-Aufträge

Werden Cron-Aufträge derzeit ausgeführt? Melden Sie sich mit ssh in der Verzweigung an und führen Sie ps aufxx |grep cron aus.

a. JA - Melden Sie sich über ssh bei der betroffenen Verzweigung an (z. B. primary). Töte und erschließe Cron-Aufträge. Dadurch werden Cron-Aufträge beendet und der Status zurückgesetzt. Führen Sie php vendor/bin/ece-tools cron:kill und dann php vendor/bin/ece-tools cron:unlock aus. Wenn Sie dabei waren, eine Umgebung in eine andere zusammenzuführen, überprüfen Sie beide Umgebungen auf aktive Crons.
b. NEIN - Mit Schritt 17 fortfahren.

Schritt 9: Fehler „Anwendung für Remote-Cluster bereitstellbar“

Die Anwendung kann nicht auf den Remote-Cluster-Fehler hochgeladen werden?

a. JA - Mit Schritt 10 fortfahren.
b. NEIN - Mit Schritt 11 fortfahren.

Schritt 10: Prüfen Sie, ob ausreichend Speicherplatz vorhanden ist

Verfügbarer Speicher okay?

a. JA - Fahren Sie mit Schritt 11 fort.
b. NEIN - Überprüfen Sie Speicherplatz verwalten.

Schritt 11: Überprüfen Sie den Festplattenspeicher.

_Datei konnte nicht geschrieben werden. Warnung _?

a. JA - Bitte den Datenträgerwert in ".magento.app.yaml“ erhöhenerneut bereitstellen. Wenn dies nicht funktioniert, ein Support-Ticket einreichen.
b. NEIN - Fahren Sie mit Schritt 12 fort.

Schritt 12: Fehler „Umgebung-Neubereitstellung fehlgeschlagen“

Fehler bei fehlgeschlagener Umgebungsbereitstellung?

a. JA - Fahren Sie mit Schritt 13 fort.
b. NEIN - Fahren Sie mit Schritt 8 fort.

Schritt 13: Überprüfung auf fehlgeschlagene Elasticsearch-Aktualisierung

Elasticsearch wird aktualisiert oder bereitgestellt?

a. JA - Fehlgeschlagene Upgrade-Schritte für Elasticsearch. Siehe Elasticsearch-Software-Kompatibilität. Wenn das Elasticsearch-Upgrade immer noch nicht funktioniert, Sie ein Support-Ticket. Hinweis: Bei Adobe Commerce auf Cloud-Infrastrukturen ist zu beachten, dass Service-Upgrades nicht ohne Vorankündigung innerhalb von 48 Geschäftsstunden an unser Infrastruktur-Team in die Produktionsumgebung übertragen werden können. Dies ist erforderlich, da wir sicherstellen müssen, dass wir einen Support-Techniker für die Infrastruktur zur Verfügung haben, der Ihre Konfiguration innerhalb des gewünschten Zeitrahmens mit minimalen Ausfallzeiten in Ihrer Produktionsumgebung aktualisiert. 48 Stunden vor dem Zeitpunkt, zu dem Ihre Änderungen in der Produktion sein müssen, Sie ein Support-Ticket, in dem Sie die erforderliche Service-Aktualisierung detailliert beschreiben und den Zeitpunkt angeben, zu dem der Upgrade-Prozess beginnen soll.
b. NEIN - Mit Schritt 14 fortfahren.

Schritt 14: Überprüfung der Speicherplatzbeschränkungen

Nicht genügend Inodes oder Speicherplatz im Dateisystem

a. JA - Siehe Speicherplatz verwalten.
b. NEIN - Mit Schritt 15 fortfahren.

Schritt 15: Elasticsearch-Versionsfehler

Fehler bei Elasticseach-Versionen?

a. JA - Mit Schritt 16 fortfahren.
b. NEIN - Mit Schritt 21 fortfahren.

Schritt 16: Überprüfen der Composer-Konfiguration

Composer-Konfiguration korrekt?

a. JA - Mit Schritt 10 fortfahren.
b. NEIN - Überprüfen Sie Composer-Fehlerbehebungs-Webseite.

Schritt 17: Prüfen auf lange laufende Prozesse

Lang laufende Prozesse?

a. JA - Ermitteln Sie Prozesse mit langer Laufzeit und beenden Sie sie dann:

Führen Sie den folgenden Befehl am Terminal aus: ps aufx.
Suchen Sie die PID des langwierigen Prozesses.
Beenden Sie den Prozess mithilfe von kill -9 <PID>.

Überwachen von Bereitstellungen auf Wiederholungen.

b. NEIN - Fahren Sie mit Schritt 18 fort.

Schritt 18 - Auf Fehler beim Pfosten-Haken prüfen

Post Hook Failure/Hang?

a. JA - Datenbank: Freier Speicherplatz, Beschädigung, unvollständige/beschädigte Tabellen.
b. NEIN - Fahren Sie mit Schritt 19 fort.

Schritt 19: Überprüfen, ob Erweiterungen von Drittanbietern die Bereitstellung blockieren

Verwendung von Erweiterungen von Drittanbietern?

A. JA - Versuchen Sie Drittanbietererweiterungen deaktivieren und führen Sie die Bereitstellung aus (um zu sehen, ob sie die Ursache des Problems sind), insbesondere wenn in Fehlern Erweiterungsnamen enthalten sind.
b. NEIN - Mit Schritt 20 fortfahren.

Schritt 20: Prüfen auf langsame Abfragen

Lang laufende Abfragen?

Überprüfen Sie das langsame Abfrageprotokoll und die Prozessliste in MySQL anzeigen.

a. JA - Alle lang laufenden Abfragen beenden. Review MySQL Kill Syntax.
b. NEIN - Support-Ticket einreichen.

Schritt 21: Elasticsearch-Version herunterladen

Elasticsearch-Versionen werden heruntergestuft?

a. JA - Kann nicht über die Konfiguration ausgeführt werden. Senden eines Support-Tickets.
b. NEIN - Support-Ticket einreichen.

Zurück zu Schritt 1

recommendation-more-help