Fehlermeldungen für ECE-Tools
Diese Referenz zu Fehlermeldungen enthält Informationen zur Fehlerbehebung bei Fehlern, die während der Prozesse zum Erstellen, Bereitstellen und Nachbereitstellen von Adobe Commerce in der Cloud-Infrastruktur auftreten können.
Alle kritischen Meldungen und Warnfehlermeldungen, die während der Bereitstellung auftreten, werden sowohl in die var/log/cloud.log
- als auch in die /var/log/cloud.error.log
-Dateien geschrieben. Die Cloud-Fehlerprotokolldatei enthält nur Fehler aus der neuesten Bereitstellung. Eine leere Datei bedeutet, dass die Bereitstellung ohne Fehler erfolgreich war.
In der cloud.error.log
-Datei wird jeder Eintrag als JSON-Zeichenfolge formatiert, um das Analysieren zu erleichtern:
{"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 Bereitstellungsphasen kategorisiert: Erstellen, Bereitstellen und Nachbereitstellen. Jeder Abschnitt enthält eine Liste der zugehörigen Fehler mit den folgenden Informationen für jeden Fehler:
- Fehlercode: Die von Adobe Commerce zugewiesene Kennung für die Fehlermeldung
- Staging: Gibt an, ob der Fehler während der Build-, Bereitstellungs- oder Nach-Bereitstellungsphase aufgetreten ist
- Schritt: Gibt den Schritt im Bereitstellungsszenario an, der den Fehler zurückgeben kann. Wenn die Schritt-Spalte leer ist, handelt es sich bei dem Fehler um einen allgemeinen Fehler, der in mehreren Schritten oder bei Vorab-Verarbeitungsvorgängen zurückgegeben werden kann. Weitere zu den SchrittenErstellen, Bereitstellen und Nachbereitstellen finden Sie unter „Szenariobasierte Bereitstellung“.
- Vorschlag: Bietet Anleitungen zur Fehlerbehebung und Fehlerbehebung
- Titel (Fehlerbeschreibung): Eine Beschreibung, die die Ursache des Fehlers zusammenfasst
- Typ: Gibt an, ob der Fehler ein kritischer Fehler oder eine Warnung ist
Kritische Fehler
Kritische Fehler weisen auf ein Problem mit der Projektkonfiguration von Commerce in der Cloud-Infrastruktur hin, das zu Bereitstellungsfehlern führt, z. B. falsche, nicht unterstützte oder fehlende Konfiguration für erforderliche Einstellungen. Bevor Sie bereitstellen können, müssen Sie die Konfiguration aktualisieren, um diese Fehler zu beheben.
Build-Phase
./app/etc/env.php
-Datei nicht möglich/app/etc/env.php
-Datei nicht vornehmen. Überprüfen Sie Ihre Dateisystemberechtigungen.schema.yaml
definiert./vendor/magento/ece-tools/config/schema.yaml
definiert. Überprüfen Sie, ob der Name der Konfigurationsvariablen korrekt und definiert ist..magento.env.yaml
konnte nicht analysiert werden./.magento.env.yaml
Dateiformat ist ungültig. Verwenden Sie einen YAML-Parser, um die Syntax zu überprüfen und Fehler zu beheben..magento.env.yaml
kann nicht gelesen werden./.magento.env.yaml
kann nicht gelesen werden. Überprüfen Sie die Dateiberechtigungen..schema.yaml
kann nicht gelesen werden./vendor/magento/ece-tools/config/magento.env.yaml
kann nicht gelesen werden. Überprüfen Sie die Dateiberechtigungen und stellen Sie erneut bereit (magento-cloud environment:redeploy
)../app/etc/config.php
Datei kann nicht geschrieben werden/app/etc/config.php
Datei vornehmen. Überprüfen Sie Ihre Dateisystemberechtigungen.composer.json
gelesen werden../composer.json
Datei kann nicht gelesen werden. Überprüfen Sie die Dateiberechtigungen.composer.json
Datei fehlt der erforderliche Abschnitt für das automatische Ladenautoload
Erforderlich Abschnitt fehlt in der composer.json
Datei. Vergleichen Sie den Abschnitt "Autoload" mit der composer.json
Datei im Cloud-Vorlage und fügen Sie die fehlende Konfiguration hinzu..magento.env.yaml
enthält eine Option, die im Schema nicht deklariert ist, oder eine Option, die mit einem ungültigen Wert oder Schritt konfiguriert wurde./.magento.env.yaml
enthält eine ungültige Konfiguration. Ausführliche Informationen finden Sie im Fehlerprotokoll./bin/magento module:enable --all
composer update
lokal auszuführen. Übertragen Sie dann die aktualisierte composer.lock
-Datei per Push. Überprüfen Sie außerdem die cloud.log
, um weitere Informationen zu erhalten. Um eine detailliertere Befehlsausgabe zu erhalten, fügen Sie die Option VERBOSE_COMMANDS: '-vvv'
zur .magento.env.yaml
hinzu./pub/errors/local.xml
nicht möglich/bin/magento setup:di:compile
cloud.log
. Fügen Sie VERBOSE_COMMANDS: '-vvv'
in .magento.env.yaml
hinzu, um eine detailliertere Befehlsausgabe zu erhalten.composer dump-autoload
composer dump-autoload
ist fehlgeschlagen. Weitere Informationen finden Sie in der cloud.log
.Baler
für die JavaScript-Bündelung ist fehlgeschlagenSCD_USE_BALER
, um sicherzustellen, dass das Modul Baler für die JS-Bündelung konfiguriert und aktiviert ist. Wenn Sie das Modul Ballenpresse nicht benötigen, stellen Sie SCD_USE_BALER: false
ein./bin/magento setup:static-content:deploy
fehlgeschlagencloud.log
. Um eine detailliertere Befehlsausgabe zu erhalten, fügen Sie die Option VERBOSE_COMMANDS: '-vvv'
zur .magento.env.yaml
hinzu.cloud.log
.init
kopiert werdencloud.log
.init
Verzeichnis zu kopieren./init
Ordner zu kopieren. Überprüfen Sie Ihre Dateisystemberechtigungen../init/pub/static/
Verzeichnis zu bereinigen./init/pub/static
. Überprüfen Sie Ihre Dateisystemberechtigungen.DEPLOYED_MAGENTO_VERSION_FROM_GIT
konfiguriert ist..magento.app.yaml
. Verwenden Sie für die Braintree-Zahlungsunterstützung stattdessen eine offizielle Erweiterung aus der Commerce Marketplace.Staging-Bereitstellung
server
oder port
. Weitere Informationen finden Sie in der cloud.log
../app/etc/env.php
-Datei nicht möglich/app/etc/env.php
-Datei nicht vornehmen. Überprüfen Sie Ihre Dateisystemberechtigungen.schema.yaml
definiert./vendor/magento/ece-tools/config/schema.yaml
Datei definiert. Überprüfen Sie, ob der Konfigurationsname Variable korrekt und definiert ist..magento.env.yaml
konnte nicht analysiert werden./vendor/magento/ece-tools/config/schema.yaml
definiert. Überprüfen Sie, ob der Name der Konfigurationsvariablen korrekt ist und ob er definiert ist..magento.env.yaml
kann nicht gelesen werden./.magento.env.yaml
kann nicht gelesen werden. Dateiberechtigungen überprüfen..schema.yaml
kann nicht gelesen werden/bin/magento maintenance:enable
fehlgeschlagencloud.log
. Um eine detailliertere Befehlsausgabe zu erhalten, fügen Sie die Option VERBOSE_COMMANDS: '-vvv'
zur .magento.env.yaml
hinzu.DATABASE_CONFIGURATION
Umgebungsvariable korrekt konfiguriert ist.SESSION_CONFIGURATION
Umgebungsvariable korrekt konfiguriert ist. Die Konfiguration muss mindestens den save
Parameter enthalten.SEARCH_CONFIGURATION
Umgebung Variable korrekt konfiguriert ist. Die Konfiguration muss mindestens den engine
Parameter enthalten.RESOURCE_CONFIGURATION
Umgebungsvariable korrekt konfiguriert ist. Die Konfiguration muss mindestens connection
Parameter enthalten.SEARCH_CONFIGURATION
Umgebungsvariable korrekt konfiguriert ist, und stellen Sie sicher, dass der Elasticsearch-Service verfügbar ist.SEARCH_CONFIGURATION
, um Elasticsearch zu aktivieren, und überprüfen Sie die Konfiguration des Elasticsearch-Services in der services.yaml
./bin/magento setup:install
fehlgeschlagencloud.log
und im install_upgrade.log
. Um eine detailliertere Befehlsausgabe zu erhalten, fügen Sie die Option VERBOSE_COMMANDS: '-vvv'
zur .magento.env.yaml
hinzu.app:config:import
fehlgeschlagencloud.log
. Für eine detailliertere Befehlsausgabe fügen Sie die VERBOSE_COMMANDS: '-vvv'
Option zur .magento.env.yaml
Datei hinzu./bin/magento setup:static-content:deploy
fehlgeschlagencloud.log
. Um eine detailliertere Befehlsausgabe zu erhalten, fügen Sie die Option VERBOSE_COMMANDS: '-vvv'
zur .magento.env.yaml
hinzu.cloud.log
../pub/static/deployed_version.txt
kann nicht aktualisiert werden. Überprüfen Sie Ihre Dateisystemberechtigungen./bin/magento setup:db-schema:split
fehlgeschlagencloud.log
. Um eine detailliertere Befehlsausgabe zu erhalten, fügen Sie die Option VERBOSE_COMMANDS: '-vvv'
zur .magento.env.yaml
hinzu.var/view_preprocessed
Ordners fehlgeschlagen./var/view_preprocessed
kann nicht bereinigt werden. Überprüfen Sie Ihre Dateisystemberechtigungen./var/credentials_email.txt
/var/credentials_email.txt
. Überprüfen Sie Ihre Dateisystemberechtigungen./bin/magento setup:upgrade
Befehl fehlgeschlagencloud.log
install_upgrade.log
Für eine detailliertere Befehlsausgabe fügen Sie die VERBOSE_COMMANDS: '-vvv'
Option zur .magento.env.yaml
Datei hinzu./bin/magento cache:flush
fehlgeschlagencloud.log
. Um eine detailliertere Befehlsausgabe zu erhalten, fügen Sie die Option VERBOSE_COMMANDS: '-vvv'
zur .magento.env.yaml
hinzu./bin/magento maintenance:disable
fehlgeschlagencloud.log
. Fügen Sie VERBOSE_COMMANDS: '-vvv'
in .magento.env.yaml
hinzu, um eine detailliertere Befehlsausgabe zu erhalten.php ./bin/magento cache:enable
php ./bin/magento cache:enable
wird nur ausgeführt, wenn Adobe Commerce installiert wurde, ./app/etc/env.php
Datei jedoch zu Beginn der Bereitstellung fehlte oder leer war. Weitere Informationen finden Sie in der cloud.log
. Fügen Sie VERBOSE_COMMANDS: '-vvv'
in .magento.env.yaml
hinzu, um eine detailliertere Befehlsausgabe zu erhalten.crypt/key
-Schlüssels ist nicht in der ./app/etc/env.php
-Datei oder der CRYPT_KEY
Cloud-Umgebungsvariablen vorhanden./app/etc/env.php
-Datei zu Beginn der Adobe Commerce-Bereitstellung nicht vorhanden ist oder der crypt/key
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 zur CloudUmgebungsvariablen „CRYPT_KEY in Ihrer aktuellen Umgebung hinzu. Siehe Adobe Commerce-Verschlüsselungsschlüssel. Wenn Sie die Datei ./app/etc/env.php
versehentlich entfernt haben, verwenden Sie den folgenden Befehl, um sie aus den Sicherungsdateien einer früheren Bereitstellung wiederherzustellen: ./vendor/bin/ece-tools backup:restore
CLI-Befehl.“.magento.app.yaml
. Verwenden Sie für den Braintree-Support stattdessen eine offizielle Braintree Payments-Erweiterung aus der Commerce Marketplace.engine
. Wenn sie konfiguriert ist, entfernen Sie die Option oder setzen den Wert auf „elasticsearch“.Phase nach der Bereitstellung
./app/etc/env.php
-Datei kann nicht beschrieben werden/app/etc/env.php
-Datei nicht vornehmen. Überprüfen Sie Ihre Dateisystemberechtigungen.schema.yaml
definiert./vendor/magento/ece-tools/config/schema.yaml
definiert. Überprüfen Sie, ob der Name der Konfigurationsvariablen korrekt ist und ob er definiert ist..magento.env.yaml
konnte nicht analysiert werden./.magento.env.yaml
Dateiformat ist ungültig. Verwenden Sie einen YAML-Parser, um die Syntax zu überprüfen und Fehler zu beheben..magento.env.yaml
kann nicht gelesen werden.schema.yaml
kann nicht gelesen werden/bin/magento cache:flush
Befehl fehlgeschlagencloud.log
. VERBOSE_COMMANDS: '-vvv'
hinzufügen für .magento.env.yaml
eine detailliertere Befehlsausgabe.Allgemein
schema.yaml
definiert.magento.env.yaml
konnte nicht analysiert werden./.magento.env.yaml
Dateiformat ist ungültig. Verwenden Sie einen YAML-Parser, um die Syntax zu überprüfen und Fehler zu beheben..magento.env.yaml
kann nicht gelesen werden./.magento.env.yaml
kann nicht gelesen werden. Dateiberechtigungen überprüfen..schema.yaml
kann nicht gelesen werdencloud.log
.cloud.log
.cloud.log
.cloud.log
.Warnung Fehler
Warnung Fehler weisen auf eine Herausforderung mit der Konfiguration von Commerce für Cloud-Infrastruktur-Projekt hin, z. B. falsche, veraltete, nicht unterstützte oder fehlende Konfigurationseinstellungen für optionale Funktionen, die sich auf den Websitebetrieb auswirken können. Obwohl eine Warnung nicht Implementierung Fehler verursacht, sollten Sie die Warnmeldungen überprüfen und die Konfiguration aktualisieren, um sie zu beheben.
Build Schritt
Bereitstellen Schritt
bin/magento admin:user:create
aus.app/etc/env.php
-Konfigurationsdatei fehlte oder war leer.cloud.log
.