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 Schritten Erstellen, 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 --allcomposer 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:compilecloud.log. Fügen Sie VERBOSE_COMMANDS: '-vvv' in .magento.env.yaml hinzu, um eine detailliertere Befehlsausgabe zu erhalten.composer dump-autoloadcomposer 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 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 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 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. 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:enablephp ./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 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.