Fehlermeldungen für ECE-Tools
Diese Fehlernachrichten-Referenz enthält Informationen zur Fehlerbehebung, die während der Adobe Commerce-Erstellung, Bereitstellung und nach der Bereitstellung durchgeführten Prozesse bei der Cloud-Infrastruktur auftreten können.
Alle kritischen und Warnmeldungen, die während der Bereitstellung auftreten, werden sowohl in var/log/cloud.log
und /var/log/cloud.error.log
-Dateien. Die Fehlerprotokolldatei der Cloud enthält nur Fehler aus der neuesten Bereitstellung. Eine leere Datei weist auf eine erfolgreiche Implementierung ohne Fehler hin.
Im cloud.error.log
-Datei, wird jeder Eintrag als JSON-Zeichenfolge formatiert, um die Analyse zu vereinfachen:
{"errorCode":1006,"stage":"build","step":"validate-config","suggestion":"No stores/website/locales found in config.php\n To speed up the deploy process do the following:\n 1. Using SSH, log in to your Magento Cloud account\n 2. Run \"php ./vendor/bin/ece-tools config:dump\"\n 3. Using SCP, copy the app/etc/config.php file to your local repository\n 4. Add, commit, and push your changes to the app/etc/config.php file","title":"The configured state is not ideal","type":"warning"}
Fehlermeldungen werden nach einer der Implementierungsphasen kategorisiert: Erstellen, Bereitstellen und Nach der Bereitstellung. Jeder Abschnitt enthält eine Liste der zugehörigen Fehler mit den folgenden Informationen zu jedem Fehler:
- Fehler-Code: Die von Adobe Commerce zugewiesene Kennung für die Fehlermeldung
- Staging: Gibt an, ob der Fehler während der Build-, Bereitstellungs- oder Postbereitstellungsphase aufgetreten ist
- Schritt: Gibt den Schritt im Bereitstellungsszenario an, der den Fehler zurückgeben kann. Wenn die Variable Schritt leer ist, handelt es sich bei dem Fehler um einen allgemeinen Fehler, der von mehreren Schritten oder während Vorab-Bearbeitungsvorgängen zurückgegeben werden kann. Siehe Szenario-basierte Bereitstellung Weitere Informationen zu den Schritten zum Erstellen, Bereitstellen und nach der Bereitstellung.
- Empfehlung: Enthält Anleitungen zur Fehlerbehebung und Fehlerbehebung
- Titel (Fehlerbeschreibung): Eine Beschreibung, die die Fehlerursache zusammenfasst
- Typ: Gibt an, ob der Fehler ein kritischer Fehler oder eine Warnung ist
Kritische Fehler
Kritische Fehler weisen auf ein Problem mit der Commerce in der Cloud-Infrastruktur-Projektkonfiguration hin, das zu einem Implementierungsfehler führt, z. B. zu einer falschen, nicht unterstützten oder fehlenden Konfiguration für die erforderlichen Einstellungen. Vor der Bereitstellung müssen Sie die Konfiguration aktualisieren, um diese Fehler zu beheben.
Build-Phase
./app/etc/env.php
file/app/etc/env.php
-Datei. Überprüfen Sie Ihre Dateisystemberechtigungen.schema.yaml
file./vendor/magento/ece-tools/config/schema.yaml
-Datei. Überprüfen Sie, ob der Name der Konfigurationsvariablen korrekt und definiert ist..magento.env.yaml
file./.magento.env.yaml
-Dateiformat ungültig ist. Verwenden Sie einen YAML-Parser, um die Syntax zu überprüfen und etwaige Fehler zu beheben..magento.env.yaml
file./.magento.env.yaml
-Datei. Überprüfen Sie die Dateiberechtigungen..schema.yaml
file./vendor/magento/ece-tools/config/magento.env.yaml
-Datei. Überprüfen Sie die Dateiberechtigungen und stellen Sie sie erneut bereit (magento-cloud environment:redeploy
)../app/etc/config.php
file/app/etc/config.php
-Datei. Überprüfen Sie Ihre Dateisystemberechtigungen.composer.json
file./composer.json
-Datei. Überprüfen Sie die Dateiberechtigungen.composer.json
-Datei fehlt der erforderliche Abschnitt zum automatischen Ladenautoload
-Abschnitt fehlt im composer.json
-Datei. Vergleichen Sie den Abschnitt "Autoload"mit dem Abschnitt composer.json
in der Cloud-Vorlage und fügen Sie die fehlende Konfiguration hinzu..magento.env.yaml
enthält eine Option, die nicht im Schema deklariert ist, oder eine Option, die mit einem ungültigen Wert oder einer ungültigen Phase konfiguriert wurde./.magento.env.yaml
-Datei enthält eine ungültige Konfiguration. Detaillierte Informationen finden Sie im Fehlerprotokoll ./bin/magento module:enable --all
composer update
lokal. Übertragen Sie dann die aktualisierte composer.lock
-Datei. Überprüfen Sie außerdem die cloud.log
für weitere Informationen. Für eine detailliertere Befehlsausgabe fügen Sie die VERBOSE_COMMANDS: '-vvv'
-Option .magento.env.yaml
-Datei./pub/errors/local.xml
/bin/magento setup:di:compile
cloud.log
für weitere Informationen. Hinzufügen VERBOSE_COMMANDS: '-vvv'
in .magento.env.yaml
für eine detailliertere Befehlsausgabe.composer dump-autoload
composer dump-autoload
-Befehl fehlgeschlagen. Überprüfen Sie die cloud.log
für weitere Informationen.Baler
für JavaScript-Bundle fehlgeschlagenSCD_USE_BALER
Umgebungsvariable, um zu überprüfen, ob das Baler-Modul für das JS-Bundling konfiguriert und aktiviert ist. Wenn Sie das Baler-Modul nicht benötigen, legen Sie SCD_USE_BALER: false
./bin/magento setup:static-content:deploy
failedcloud.log
für weitere Informationen. Für eine detailliertere Befehlsausgabe fügen Sie die VERBOSE_COMMANDS: '-vvv'
-Option .magento.env.yaml
-Datei.cloud.log
für weitere Informationen.init
directorycloud.log
für weitere Informationen.init
directory./init
Ordner. Überprüfen Sie Ihre Dateisystemberechtigungen../init/pub/static/
directory./init/pub/static
Ordner. Überprüfen Sie Ihre Dateisystemberechtigungen.DEPLOYED_MAGENTO_VERSION_FROM_GIT
Umgebungsvariable konfiguriert ist..magento.app.yaml
-Datei. Verwenden Sie stattdessen eine offizielle Erweiterung der Braintree-Zahlungsunterstützung von der Commerce Marketplace.Bereitstellungsphase
server
oder port
. Überprüfen Sie die cloud.log
für weitere Informationen../app/etc/env.php
file/app/etc/env.php
-Datei. Überprüfen Sie Ihre Dateisystemberechtigungen.schema.yaml
file./vendor/magento/ece-tools/config/schema.yaml
-Datei. Überprüfen Sie, ob der Name der Konfigurationsvariablen korrekt ist und ob er definiert ist..magento.env.yaml
file./vendor/magento/ece-tools/config/schema.yaml
-Datei. Überprüfen Sie, ob der Name der Konfigurationsvariablen korrekt ist und ob er definiert ist..magento.env.yaml
file./.magento.env.yaml
-Datei. Überprüfen Sie die Dateiberechtigungen..schema.yaml
file/bin/magento maintenance:enable
failedcloud.log
für weitere Informationen. Für eine detailliertere Befehlsausgabe fügen Sie die VERBOSE_COMMANDS: '-vvv'
-Option .magento.env.yaml
-Datei.DATABASE_CONFIGURATION
-Umgebungsvariable korrekt konfiguriert ist.SESSION_CONFIGURATION
-Umgebungsvariable korrekt konfiguriert ist. Die Konfiguration muss mindestens die Variable save
-Parameter.SEARCH_CONFIGURATION
-Umgebungsvariable korrekt konfiguriert ist. Die Konfiguration muss mindestens die Variable engine
-Parameter.RESOURCE_CONFIGURATION
-Umgebungsvariable korrekt konfiguriert ist. Die Konfiguration muss mindestens Folgendes enthalten: connection
-Parameter.SEARCH_CONFIGURATION
Umgebungsvariable korrekt konfiguriert ist, und überprüfen Sie, ob der Elasticsearch-Dienst verfügbar ist.SEARCH_CONFIGURATION
Umgebungsvariable, um Elasticsearch zu aktivieren und die Elasticsearch-Dienstkonfiguration in der services.yaml
-Datei./bin/magento setup:install
failedcloud.log
und install_upgrade.log
für weitere Informationen. Für eine detailliertere Befehlsausgabe fügen Sie die VERBOSE_COMMANDS: '-vvv'
-Option .magento.env.yaml
-Datei.app:config:import
failedcloud.log
für weitere Informationen. Für eine detailliertere Befehlsausgabe fügen Sie die VERBOSE_COMMANDS: '-vvv'
-Option .magento.env.yaml
-Datei./bin/magento setup:static-content:deploy
failedcloud.log
für weitere Informationen. Für eine detailliertere Befehlsausgabe fügen Sie die VERBOSE_COMMANDS: '-vvv'
-Option .magento.env.yaml
-Datei.cloud.log
für weitere Informationen../pub/static/deployed_version.txt
-Datei. Überprüfen Sie Ihre Dateisystemberechtigungen./bin/magento setup:db-schema:split
failedcloud.log
für weitere Informationen. Für eine detailliertere Befehlsausgabe fügen Sie die VERBOSE_COMMANDS: '-vvv'
-Option .magento.env.yaml
-Datei.var/view_preprocessed
Ordner./var/view_preprocessed
Ordner. Überprüfen Sie Ihre Dateisystemberechtigungen./var/credentials_email.txt
file/var/credentials_email.txt
-Datei. Überprüfen Sie Ihre Dateisystemberechtigungen./bin/magento setup:upgrade
failedcloud.log
und install_upgrade.log
für weitere Informationen. Für eine detailliertere Befehlsausgabe fügen Sie die VERBOSE_COMMANDS: '-vvv'
-Option .magento.env.yaml
-Datei./bin/magento cache:flush
failedcloud.log
für weitere Informationen. Für eine detailliertere Befehlsausgabe fügen Sie die VERBOSE_COMMANDS: '-vvv'
-Option .magento.env.yaml
-Datei./bin/magento maintenance:disable
failedcloud.log
für weitere Informationen. Hinzufügen VERBOSE_COMMANDS: '-vvv'
in .magento.env.yaml
für eine detailliertere Befehlsausgabe.php ./bin/magento cache:enable
php ./bin/magento cache:enable
wird nur ausgeführt, wenn Adobe Commerce installiert ist, aber ./app/etc/env.php
-Datei zu Beginn der Bereitstellung fehlte oder war leer. Überprüfen Sie die cloud.log
für weitere Informationen. Hinzufügen VERBOSE_COMMANDS: '-vvv'
in .magento.env.yaml
für eine detailliertere Befehlsausgabe.crypt/key
Der Schlüsselwert ist nicht im ./app/etc/env.php
oder CRYPT_KEY
Cloud-Umgebungsvariable./app/etc/env.php
nicht vorhanden ist, wenn die Adobe Commerce-Bereitstellung beginnt oder wenn die crypt/key
-Wert nicht definiert ist. Wenn Sie die Datenbank aus einer anderen Umgebung migriert haben, rufen Sie den Wert des Verschlüsselungsschlüssels aus dieser Umgebung ab. Fügen Sie dann den Wert zum CRYPT_KEY Cloud-Umgebungsvariable in Ihrer aktuellen Umgebung. Siehe Adobe Commerce-Verschlüsselungsschlüssel. Wenn Sie versehentlich die ./app/etc/env.php
verwenden Sie den folgenden Befehl, um sie aus den Sicherungsdateien wiederherzustellen, die aus einer vorherigen Bereitstellung erstellt wurden: ./vendor/bin/ece-tools backup:restore
CLI-Befehl .".magento.app.yaml
-Datei. Verwenden Sie stattdessen eine offizielle Braintree Payments-Erweiterung von der Commerce Marketplace, um Braintree zu unterstützen.engine
-Option. Wenn sie konfiguriert ist, entfernen Sie die Option oder setzen Sie den Wert auf "elasticsearch".Phase nach der Bereitstellung
./app/etc/env.php
Datei nicht schreibbar/app/etc/env.php
-Datei. Überprüfen Sie Ihre Dateisystemberechtigungen.schema.yaml
file./vendor/magento/ece-tools/config/schema.yaml
-Datei. Überprüfen Sie, ob der Name der Konfigurationsvariablen korrekt ist und ob er definiert ist..magento.env.yaml
file./.magento.env.yaml
-Dateiformat ungültig ist. Verwenden Sie einen YAML-Parser, um die Syntax zu überprüfen und etwaige Fehler zu beheben..magento.env.yaml
file.schema.yaml
file/bin/magento cache:flush
failedcloud.log
für weitere Informationen. Hinzufügen VERBOSE_COMMANDS: '-vvv'
in .magento.env.yaml
für eine detailliertere Befehlsausgabe.Allgemein
schema.yaml
file.magento.env.yaml
file./.magento.env.yaml
-Dateiformat ungültig ist. Verwenden Sie einen YAML-Parser, um die Syntax zu überprüfen und etwaige Fehler zu beheben..magento.env.yaml
file./.magento.env.yaml
-Datei. Überprüfen Sie die Dateiberechtigungen..schema.yaml
filecloud.log
für weitere Informationen.cloud.log
für weitere Informationen.cloud.log
für weitere Informationen.cloud.log
für weitere Informationen.Warnfehler
Warnungsfehler weisen auf ein Problem mit der Commerce in der Cloud-Infrastruktur-Projektkonfiguration hin, z. B. falsche, veraltete, nicht unterstützte oder fehlende Konfigurationseinstellungen für optionale Funktionen, die sich auf den Site-Betrieb auswirken können. Obwohl eine Warnung keinen Bereitstellungsfehler verursacht, sollten Sie Warnmeldungen überprüfen und die Konfiguration aktualisieren, um sie zu beheben.
Build-Phase
Bereitstellungsphase
bin/magento admin:user:create
Befehl.app/etc/env.php
-Konfigurationsdatei fehlte oder leer war.cloud.log
für weitere Informationen.