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 in die Dateien var/log/cloud.log
und /var/log/cloud.error.log
geschrieben. Die Fehlerprotokolldatei der Cloud enthält nur Fehler aus der neuesten Bereitstellung. Eine leere Datei weist auf eine erfolgreiche Implementierung ohne Fehler hin.
In der Datei cloud.error.log
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:
- Fehlercode: 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 Spalte Schritt leer ist, handelt es sich bei dem Fehler um einen allgemeinen Fehler, der von mehreren Schritten oder während Vorverarbeitungsvorgängen zurückgegeben werden kann. Weitere Informationen zu den Schritten zum Erstellen, Bereitstellen und nach der Bereitstellung finden Sie unter Scenario-basierte Bereitstellung .
- Empfehlung: Bietet 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
schreiben/app/etc/env.php
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
-Datei./.magento.env.yaml
-Dateiformat ist ungültig. Verwenden Sie einen YAML-Parser, um die Syntax zu überprüfen und etwaige 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 sie erneut bereit (magento-cloud environment:redeploy
)../app/etc/config.php
schreiben/app/etc/config.php
vornehmen. Überprüfen Sie Ihre Dateisystemberechtigungen.composer.json
-Datei kann nicht gelesen werden./composer.json
kann nicht gelesen werden. Überprüfen Sie die Dateiberechtigungen.composer.json
" fehlt im erforderlichen Abschnitt zum automatischen Ladenautoload
-Abschnitt fehlt in der composer.json
-Datei. Vergleichen Sie den Abschnitt "Autoload"mit der Datei "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
enthält eine ungültige Konfiguration. Detaillierte Informationen finden Sie im Fehlerprotokoll ./bin/magento module:enable --all
composer update
lokal auszuführen. Übertragen Sie dann die aktualisierte composer.lock
-Datei und pushen Sie sie. Weitere Informationen finden Sie auch unter cloud.log
. Um eine detailliertere Befehlsausgabe zu erhalten, fügen Sie die Option VERBOSE_COMMANDS: '-vvv'
zur Datei .magento.env.yaml
hinzu./pub/errors/local.xml
schreiben/bin/magento setup:di:compile
cloud.log
. Fügen Sie VERBOSE_COMMANDS: '-vvv'
zu .magento.env.yaml
hinzu, um eine detailliertere Befehlsausgabe zu erhalten.composer dump-autoload
composer dump-autoload
ist fehlgeschlagen. Weitere Informationen finden Sie unter cloud.log
.Baler
für JavaScript-Bundle ist fehlgeschlagen.SCD_USE_BALER
, um sicherzustellen, dass das Baler-Modul für das JS-Bundling konfiguriert und aktiviert ist. Wenn Sie das Baler-Modul nicht benötigen, setzen Sie SCD_USE_BALER: false
./bin/magento setup:static-content:deploy
fehlgeschlagencloud.log
. Um eine detailliertere Befehlsausgabe zu erhalten, fügen Sie die Option VERBOSE_COMMANDS: '-vvv'
zur Datei .magento.env.yaml
hinzu.cloud.log
.init
kopiert werdencloud.log
.init
./init
kopiert werden. Überprüfen Sie Ihre Dateisystemberechtigungen../init/pub/static/
./init/pub/static
konnte nicht gelöscht werden. Überprüfen Sie Ihre Dateisystemberechtigungen.DEPLOYED_MAGENTO_VERSION_FROM_GIT
konfiguriert ist..magento.app.yaml
. Verwenden Sie stattdessen eine offizielle Erweiterung der Braintree-Zahlungsunterstützung von der Commerce Marketplace.Bereitstellungsphase
server
oder port
. Weitere Informationen finden Sie unter cloud.log
../app/etc/env.php
schreiben/app/etc/env.php
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
-Datei./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. Überprüfen Sie die Dateiberechtigungen..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 Datei .magento.env.yaml
hinzu.DATABASE_CONFIGURATION
richtig konfiguriert ist.SESSION_CONFIGURATION
richtig konfiguriert ist. Die Konfiguration muss mindestens den Parameter save
enthalten.SEARCH_CONFIGURATION
richtig konfiguriert ist. Die Konfiguration muss mindestens den Parameter engine
enthalten.RESOURCE_CONFIGURATION
richtig konfiguriert ist. Die Konfiguration muss mindestens den Parameter connection
enthalten.SEARCH_CONFIGURATION
korrekt konfiguriert ist, und stellen Sie sicher, dass der Elasticsearch-Dienst verfügbar ist.SEARCH_CONFIGURATION
", um Elasticsearch zu aktivieren, und überprüfen Sie die Konfiguration des Elasticsearch-Diensts in der Datei "services.yaml
"./bin/magento setup:install
fehlgeschlagencloud.log
und install_upgrade.log
. Um eine detailliertere Befehlsausgabe zu erhalten, fügen Sie die Option VERBOSE_COMMANDS: '-vvv'
zur Datei .magento.env.yaml
hinzu.app:config:import
fehlgeschlagencloud.log
. Um eine detailliertere Befehlsausgabe zu erhalten, fügen Sie die Option VERBOSE_COMMANDS: '-vvv'
zur Datei .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 Datei .magento.env.yaml
hinzu.cloud.log
../pub/static/deployed_version.txt
-Datei 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 Datei .magento.env.yaml
hinzu.var/view_preprocessed
./var/view_preprocessed
kann nicht bereinigt werden. Überprüfen Sie Ihre Dateisystemberechtigungen./var/credentials_email.txt
-Datei konnte nicht aktualisiert werden/var/credentials_email.txt
-Datei konnte nicht aktualisiert werden. Überprüfen Sie Ihre Dateisystemberechtigungen./bin/magento setup:upgrade
fehlgeschlagencloud.log
und install_upgrade.log
. Um eine detailliertere Befehlsausgabe zu erhalten, fügen Sie die Option VERBOSE_COMMANDS: '-vvv'
zur Datei .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 Datei .magento.env.yaml
hinzu./bin/magento maintenance:disable
fehlgeschlagencloud.log
. Fügen Sie VERBOSE_COMMANDS: '-vvv'
zu .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, die Datei ./app/etc/env.php
jedoch zu Beginn der Bereitstellung fehlte oder leer war. Weitere Informationen finden Sie unter cloud.log
. Fügen Sie VERBOSE_COMMANDS: '-vvv'
zu .magento.env.yaml
hinzu, um eine detailliertere Befehlsausgabe zu erhalten.crypt/key
ist nicht in der Datei ./app/etc/env.php
oder der Cloud-Umgebungsvariablen CRYPT_KEY
vorhanden./app/etc/env.php
-Datei nicht vorhanden ist, wenn die Adobe Commerce-Bereitstellung beginnt, oder wenn der 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 der Cloud-Umgebungsvariablen CRYPT_KEY in Ihrer aktuellen Umgebung hinzu. Siehe Adobe Commerce-Verschlüsselungsschlüssel. Wenn Sie versehentlich die Datei ./app/etc/env.php
entfernt haben, 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
. Verwenden Sie stattdessen eine offizielle Braintree Payments-Erweiterung von der Commerce Marketplace, um Braintree zu unterstützen.engine
. Wenn sie konfiguriert ist, entfernen Sie die Option oder setzen Sie den Wert auf "elasticsearch".Post-Bereitstellungsphase
./app/etc/env.php
" kann nicht geschrieben werden/app/etc/env.php
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
-Datei./.magento.env.yaml
-Dateiformat ist ungültig. Verwenden Sie einen YAML-Parser, um die Syntax zu überprüfen und etwaige 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'
zu .magento.env.yaml
hinzu, um eine detailliertere Befehlsausgabe zu erhalten.Allgemein
schema.yaml
definiert.magento.env.yaml
-Datei./.magento.env.yaml
-Dateiformat ist ungültig. Verwenden Sie einen YAML-Parser, um die Syntax zu überprüfen und etwaige 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 werdencloud.log
.cloud.log
.cloud.log
.cloud.log
.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
aus.app/etc/env.php
fehlte oder war leer.cloud.log
.