Dokumentation

Fehlerbehebung bei der Adobe Commerce-Bereitstellung

Last update: Fri Dec 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

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.

Beschreibung description

Umgebung

Adobe Commerce auf Cloud-Infrastruktur

Problem/Symptome

  • Bereitstellung in einer Umgebung blockiert oder schlägt fehl
  • Blockierte Bereitstellungen aufgrund laufender Aktivitäten in anderen Umgebungen
  • SSH-Zugriffsprobleme auf Knoten
  • Dienste werden nicht ausgeführt (z. B. Elasticsearch, Cron, Composer-bezogen)
  • Nicht genügend Speicherplatz oder Inode-Beschränkungen
  • 403-/Elasticsearch-Versions-/Konfigurationsfehler
  • Fehler beim Hochladen von Remoteclustern oder beim erneuten Bereitstellen von Clustern
  • Lang laufende Prozesse, Fehler nach dem Hook oder Konflikte mit Erweiterungen von Drittanbietern
  • Langsame Abfragen und datenbankseitige Probleme (MySQL)
  • Konfigurationsprobleme von Composer oder Patch-Einschränkungen

Lösung resolution

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 (unter Experience Cloud auf der Seite AdobeStatus).

  • JA - Mit Schritt 2 fortfahren.
  • 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 zu Commerce in Cloud Manager.

code language-none 
magento-cloud --state=in_progress

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

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

Um Informationen zu einer bestehenden Bereitstellungsaktivität zu erhalten (siehe Überprüfen des Bereitstellungsprotokolls, wenn in der Cloud-Benutzeroberfläche der Fehler „Log versendet“ ​), können Sie diesen Befehl ausführen, um ein ausführendes Protokoll dieser Aktivität abzurufen.

code language-none 
magento-cloud activity:log <activity-id>[ OPTIONAL: <-p project-id or project-url>]
  • JA - Fehlerbehebung bei Problemen mit der anderen Umgebung, die die Bereitstellung blockieren. Fahren Sie mit Schritt 3 fort.
  • NEIN - Fehlerbehebung in der aktuellen Umgebung. Fahren Sie mit Schritt 3 fort.

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

SSH erfolgreich an alle Knoten gesendet?

Schritt 4: Überprüfen aller laufenden Dienste

Alle Dienste werden ausgeführt?

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

Verwenden Sie Bitbucket?

Schritt 6: Fehlercodes überprüfen

Fehlercode gemeldet?
  • JA - Mit Schritt 7 fortfahren.
  • NEIN - Fahren Sie mit Schritt 8 fort.

Schritt 7: 403 Fehler „Forbidden“

403 verboten?
  • JA - Mit Schritt 16 fortfahren.
  • NEIN - Mit Schritt 9 fortfahren.

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

Werden Cron-Aufträge derzeit ausgeführt? Melden Sie sich von SSH in der Verzweigung an und führen Sie Folgendes aus:
code language-none 
ps aufxx | grep cron

  • JA - Cron-Jobs töten und freischalten:

    code language-none 
    php vendor/bin/ece-tools cron:kill

    php vendor/bin/ece-tools cron:unlock

  • NEIN - Fahren Sie mit Schritt 17 fort.

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

Programm kann nicht auf den Remote-Cluster-Fehler hochgeladen werden?
  • JA - Mit Schritt 10 fortfahren.
  • NEIN - Fahren Sie mit Schritt 11 fort.

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

Verfügbarer Speicher okay?

Schritt 11: Überprüfen Sie den Festplattenspeicher.

Datei konnte nicht geschrieben werden. Warnung?

  • JA -

    • Für Integrations-/Starter-Umgebungen: Erhöhen Sie den Festplattenwert in .magento.app.yaml und stellen Sie erneut bereit. Wenn dies nicht funktioniert, ein Support-Ticket einreichen. Löschen Sie alternativ große Protokolldateien:
    code language-none 
    ls -la var/log

  • NEIN - Fahren Sie mit Schritt 12 fort.

Schritt 12: Fehler „Umgebung-Neubereitstellung fehlgeschlagen“

Fehler bei fehlgeschlagener Umgebungsbereitstellung?
  • JA - Mit Schritt 13 fortfahren.
  • NEIN - Fahren Sie mit Schritt 8 fort.

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

Elasticsearch wird aktualisiert oder bereitgestellt?
  • JA - Elasticsearch-Upgrade-Schritte fehlgeschlagen. 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 an unser Infrastruktur-Team innerhalb von 48 Geschäftsstunden in die Produktionsumgebung verschoben 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. Senden Sie also 48 Stunden vor dem Zeitpunkt, zu dem Ihre Änderungen in die Produktion aufgenommen werden müssen, ein Support-Ticket, in dem Ihr erforderliches Service-Upgrade detailliert aufgeführt ist und Sie den Zeitpunkt angeben, zu dem das Upgrade beginnen soll.
  • NEIN - Mit Schritt 14 fortfahren.

Schritt 14: Überprüfung der Speicherplatzbeschränkungen

Ist im Dateisystem nicht genügend Inodes oder Speicherplatz vorhanden?

Schritt 15: Elasticsearch-Versionsfehler

Fehler bei Elasticsearch-Versionen?
  • JA - Mit Schritt 16 fortfahren.
  • NEIN - Mit Schritt 21 fortfahren.

Schritt 16: Überprüfen der Composer-Konfiguration

Composer-Konfiguration korrekt?

Schritt 17: Prüfen auf lange laufende Prozesse

Lange laufende Prozesse?

  • JA - Prozesse beenden:

    1. Durchgang: ps aufx
    2. PID suchen
    3. Beenden: kill -9 <PID>

  • NEIN - Fahren Sie mit Schritt 18 fort.

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

Fehler/Absturz des Post-Hooks?
  • JA - Datenbank: Freier Speicherplatz, Beschädigung, unvollständige/beschädigte Tabellen.
  • NEIN - Fahren Sie mit Schritt 19 fort.

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

Verwenden Sie Erweiterungen von Drittanbietern?

Schritt 20: Prüfen auf langsame Abfragen

Lange laufende Abfragen?

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

Schritt 21: Elasticsearch-Version herunterladen

Elasticsearch-Versionen werden heruntergestuft?
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f