Messaggi di errore per gli strumenti ECE
Questo riferimento ai messaggi di errore fornisce informazioni per la risoluzione dei problemi che possono verificarsi durante i processi di creazione, distribuzione e post-distribuzione di Adobe Commerce su infrastrutture cloud.
Tutti i messaggi di errore critici e di avvertenza che si verificano durante la distribuzione vengono scritti sia nei file var/log/cloud.log che in quelli /var/log/cloud.error.log. Il file di registro degli errori del cloud contiene solo errori della distribuzione più recente. Un file vuoto indica una distribuzione riuscita senza errori.
Nel file cloud.error.log, ogni voce è formattata come stringa JSON per facilitarne l'analisi:
{"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"}
I messaggi di errore sono suddivisi in categorie in base a una delle fasi di distribuzione: compilazione, distribuzione e post-distribuzione. Ogni sezione fornisce un elenco degli errori associati con le seguenti informazioni per ogni errore:
- Codice errore: identificatore assegnato da Adobe Commerce per il messaggio di errore
- Fase: indica se l'errore si è verificato durante la fase di compilazione, distribuzione o post-distribuzione
- Passaggio: indica il passaggio nello scenario di distribuzione che può restituire l'errore. Se la colonna Passaggio è vuota, si tratta di un errore generale che può essere restituito da più passaggi o durante le operazioni di pre-elaborazione. Per ulteriori informazioni sui passaggi di compilazione, distribuzione e post-distribuzione, vedere Distribuzione basata su scenari.
- Suggerimento: fornisce indicazioni per risolvere i problemi e risolvere l'errore
- Titolo (descrizione errore): descrizione che riepiloga la causa dell'errore
- Tipo: indica se l'errore è un errore critico o un avviso
Errori critici
Gli errori critici indicano un problema nella configurazione del progetto Commerce su infrastruttura cloud che causa un errore di distribuzione, ad esempio una configurazione errata, non supportata o mancante per le impostazioni richieste. Prima di poter distribuire, devi aggiornare la configurazione per risolvere questi errori.
Fase build
./app/etc/env.php/app/etc/env.php. Verifica le autorizzazioni del file system.schema.yaml./vendor/magento/ece-tools/config/schema.yaml. Verifica che il nome della variabile di configurazione sia corretto e definito..magento.env.yaml./.magento.env.yaml non è valido. Utilizza un parser YAML per verificare la sintassi e correggere eventuali errori..magento.env.yaml./.magento.env.yaml. Verificare le autorizzazioni del file..schema.yaml./vendor/magento/ece-tools/config/magento.env.yaml. Controllare le autorizzazioni del file e ridistribuire (magento-cloud environment:redeploy)../app/etc/config.php/app/etc/config.php. Verifica le autorizzazioni del file system.composer.json./composer.json. Verificare le autorizzazioni del file.composer.json manca la sezione di caricamento automatico richiestaautoload richiesta non è presente nel file composer.json. Confronta la sezione del caricamento automatico con il file composer.json nel modello Cloud e aggiungi la configurazione mancante..magento.env.yaml contiene un'opzione non dichiarata nello schema oppure un'opzione configurata con un valore o una fase non valida./.magento.env.yaml contiene una configurazione non valida. Per informazioni dettagliate, consulta il registro degli errori./bin/magento module:enable --allcomposer update localmente. Quindi, eseguire il commit e inviare il file composer.lock aggiornato. Controllare inoltre cloud.log per ulteriori informazioni. Per un output di comando più dettagliato, aggiungere l'opzione VERBOSE_COMMANDS: '-vvv' al file .magento.env.yaml./pub/errors/local.xml/bin/magento setup:di:compilecloud.log. Aggiungere VERBOSE_COMMANDS: '-vvv' in .magento.env.yaml per ottenere un output di comando più dettagliato.composer dump-autoloadcomposer dump-autoload non riuscito. Per ulteriori informazioni, controllare cloud.log.Baler per il bundling di JavaScript non riuscitoSCD_USE_BALER per verificare che il modulo Baler sia configurato e abilitato per il bundle JS. Se non è necessario il modulo Baler, impostare SCD_USE_BALER: false./bin/magento setup:static-content:deploy non riuscitocloud.log. Per un output di comando più dettagliato, aggiungere l'opzione VERBOSE_COMMANDS: '-vvv' al file .magento.env.yaml.cloud.log.initcloud.log.init./init. Verifica le autorizzazioni del file system../init/pub/static/./init/pub/static. Verifica le autorizzazioni del file system.DEPLOYED_MAGENTO_VERSION_FROM_GIT sia configurata..magento.app.yaml. Per il supporto dei pagamenti Braintree, utilizza invece un’estensione ufficiale di Commerce Marketplace.Fase di distribuzione
server o port. Per ulteriori informazioni, controllare cloud.log../app/etc/env.php/app/etc/env.php. Verifica le autorizzazioni del file system.schema.yaml./vendor/magento/ece-tools/config/schema.yaml. Verifica che il nome della variabile di configurazione sia corretto e che sia definito..magento.env.yaml./vendor/magento/ece-tools/config/schema.yaml. Verifica che il nome della variabile di configurazione sia corretto e che sia definito..magento.env.yaml./.magento.env.yaml. Verificare le autorizzazioni del file..schema.yaml/bin/magento maintenance:enable non riuscitocloud.log. Per un output di comando più dettagliato, aggiungere l'opzione VERBOSE_COMMANDS: '-vvv' al file .magento.env.yaml.DATABASE_CONFIGURATION sia configurata correttamente.SESSION_CONFIGURATION sia configurata correttamente. La configurazione deve contenere almeno il parametro save.SEARCH_CONFIGURATION sia configurata correttamente. La configurazione deve contenere almeno il parametro engine.RESOURCE_CONFIGURATION sia configurata correttamente. La configurazione deve contenere almeno il parametro connection.SEARCH_CONFIGURATION sia configurata correttamente e che il servizio Elasticsearch sia disponibile.SEARCH_CONFIGURATION per abilitare Elasticsearch e verificare la configurazione del servizio Elasticsearch nel file services.yaml./bin/magento setup:install non riuscitocloud.log e install_upgrade.log. Per un output di comando più dettagliato, aggiungere l'opzione VERBOSE_COMMANDS: '-vvv' al file .magento.env.yaml.app:config:import non riuscitocloud.log. Per un output di comando più dettagliato, aggiungere l'opzione VERBOSE_COMMANDS: '-vvv' al file .magento.env.yaml./bin/magento setup:static-content:deploy non riuscitocloud.log. Per un output di comando più dettagliato, aggiungere l'opzione VERBOSE_COMMANDS: '-vvv' al file .magento.env.yaml.cloud.log../pub/static/deployed_version.txt. Verifica le autorizzazioni del file system./bin/magento setup:db-schema:split non riuscitocloud.log. Per un output di comando più dettagliato, aggiungere l'opzione VERBOSE_COMMANDS: '-vvv' al file .magento.env.yaml.var/view_preprocessed./var/view_preprocessed. Verifica le autorizzazioni del file system./var/credentials_email.txt/var/credentials_email.txt. Verifica le autorizzazioni del file system./bin/magento setup:upgrade non riuscitocloud.log e install_upgrade.log. Per un output di comando più dettagliato, aggiungere l'opzione VERBOSE_COMMANDS: '-vvv' al file .magento.env.yaml./bin/magento cache:flush non riuscitocloud.log. Per un output di comando più dettagliato, aggiungere l'opzione VERBOSE_COMMANDS: '-vvv' al file .magento.env.yaml./bin/magento maintenance:disable non riuscitocloud.log. Aggiungere VERBOSE_COMMANDS: '-vvv' in .magento.env.yaml per ottenere un output di comando più dettagliato.php ./bin/magento cache:enablephp ./bin/magento cache:enable viene eseguito solo quando è stato installato Adobe Commerce, ma il file ./app/etc/env.php era assente o vuoto all'inizio della distribuzione. Per ulteriori informazioni, controllare cloud.log. Aggiungere VERBOSE_COMMANDS: '-vvv' in .magento.env.yaml per ottenere un output di comando più dettagliato.crypt/key non esiste nel file ./app/etc/env.php o nella variabile di ambiente cloud CRYPT_KEY./app/etc/env.php non è presente all'inizio della distribuzione di Adobe Commerce o se il valore crypt/key non è definito. Se è stata eseguita la migrazione del database da un altro ambiente, recuperare il valore della chiave di crittografia da tale ambiente. Quindi, aggiungi il valore alla variabile di ambiente cloud CRYPT_KEY nell'ambiente corrente. Vedi Chiave di crittografia Adobe Commerce. Se il file ./app/etc/env.php è stato rimosso accidentalmente, utilizzare il comando seguente per ripristinarlo dai file di backup creati da una distribuzione precedente: comando CLI ./vendor/bin/ece-tools backup:restore.".magento.app.yaml. Per il supporto di Braintree, utilizza invece un’estensione ufficiale di Braintree Payments di Commerce Marketplace.engine. Se è configurata, rimuovi l’opzione o imposta il valore su "elasticsearch".Fase post-distribuzione
./app/etc/env.php non scrivibile/app/etc/env.php. Verifica le autorizzazioni del file system.schema.yaml./vendor/magento/ece-tools/config/schema.yaml. Verifica che il nome della variabile di configurazione sia corretto e che sia definito..magento.env.yaml./.magento.env.yaml non è valido. Utilizza un parser YAML per verificare la sintassi e correggere eventuali errori..magento.env.yaml.schema.yaml/bin/magento cache:flush non riuscitocloud.log. Aggiungere VERBOSE_COMMANDS: '-vvv' in .magento.env.yaml per ottenere un output di comando più dettagliato.Generale
schema.yaml.magento.env.yaml./.magento.env.yaml non è valido. Utilizza un parser YAML per verificare la sintassi e correggere eventuali errori..magento.env.yaml./.magento.env.yaml. Verificare le autorizzazioni del file..schema.yamlcloud.log.cloud.log.cloud.log.cloud.log.Errori di avvertenza
Gli errori di avvertenza indicano un problema nella configurazione del progetto Commerce su infrastruttura cloud, ad esempio impostazioni di configurazione errate, obsolete, non supportate o mancanti per le funzioni facoltative che possono influire sul funzionamento del sito. Anche se un avviso non causa errori di distribuzione, è necessario rivedere i messaggi di avviso e aggiornare la configurazione per risolverli.
Fase build
Fase di distribuzione
bin/magento admin:user:create.app/etc/env.php era mancante o vuoto.cloud.log.