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 --all
composer 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:compile
cloud.log
. Aggiungere VERBOSE_COMMANDS: '-vvv'
in .magento.env.yaml
per ottenere un output di comando più dettagliato.composer dump-autoload
composer dump-autoload
non riuscito. Per ulteriori informazioni, controllare cloud.log
.Baler
per il bundling 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
.init
cloud.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 del pagamento Braintree, utilizza invece un'estensione ufficiale dalla 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:enable
php ./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: ./vendor/bin/ece-tools backup:restore
Comando CLI.".magento.app.yaml
. Per il supporto Braintree, utilizza invece un’estensione ufficiale per i pagamenti di Braintree dalla Commerce Marketplace.engine
. Se è configurata, rimuovi l’opzione o imposta il valore su "elasticsearch".Fase di distribuzione di Post
./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.yaml
cloud.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
.