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. Dateiberechtigungen überprüfen..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 nicht möglich/app/etc/config.php
-Datei nicht vornehmen. Überprüfen Sie Ihre Dateisystemberechtigungen.composer.json
Datei kann nicht gelesen werden./composer.json
kann nicht gelesen werden. Dateiberechtigungen überprüfen.composer.json
-Datei fehlt der erforderliche Autoload-Abschnittautoload
fehlt in der composer.json
. Vergleichen Sie den Abschnitt „Autoload“ mit der composer.json
in der 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
kopiert werden./init
kopiert werden. Überprüfen Sie Ihre Dateisystemberechtigungen../init/pub/static/
-Verzeichnisses fehlgeschlagen./init/pub/static
Ordners fehlgeschlagen. Ü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 von 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
definiert. Überprüfen Sie, ob der Name der Konfigurationsvariablen korrekt ist und ob er 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
Umgebungsvariable 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
korrekt konfiguriert ist, und stellen Sie sicher, dass der Elasticsearch-Service verfügbar ist.SEARCH_CONFIGURATION
, um das Elasticsearch zu aktivieren, und überprüfen Sie die Elasticsearch-Service-Konfiguration 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
. Um eine detailliertere Befehlsausgabe zu erhalten, fügen Sie die Option VERBOSE_COMMANDS: '-vvv'
zur .magento.env.yaml
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
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./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 die Braintree-Unterstützung stattdessen eine offizielle Braintree Payments-Erweiterung von 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
fehlgeschlagencloud.log
. Fügen Sie VERBOSE_COMMANDS: '-vvv'
in .magento.env.yaml
hinzu, um eine detailliertere Befehlsausgabe zu erhalten.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
.Warnungsfehler
Warnfehler weisen auf ein Problem mit der Projektkonfiguration von Commerce in der Cloud-Infrastruktur hin, z. B. falsche, veraltete, nicht unterstützte oder fehlende Konfigurationseinstellungen für optionale Funktionen, die den Site-Betrieb beeinträchtigen können. Obwohl eine Warnung nicht zu Bereitstellungsfehlern führt, sollten Sie Warnmeldungen überprüfen und die Konfiguration aktualisieren, um sie zu beheben.
Build-Phase
Staging-Bereitstellung
bin/magento admin:user:create
aus.app/etc/env.php
-Konfigurationsdatei fehlte oder war leer.cloud.log
.