Mensajes de error para ECE-Tools
Esta referencia de mensaje de error proporciona información para solucionar errores que pueden producirse durante los procesos de creación, implementación y posterior a la implementación de Adobe Commerce en la infraestructura en la nube.
Todos los mensajes de error críticos y de advertencia que se producen durante la implementación se escriben en los archivos var/log/cloud.log
y /var/log/cloud.error.log
. El archivo de registro de errores de la nube solo contiene errores de la implementación más reciente. Un archivo vacío indica una implementación correcta sin errores.
En el archivo cloud.error.log
, cada entrada tiene el formato de una cadena JSON para facilitar el análisis:
{"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"}
Los mensajes de error se clasifican por una de las etapas de implementación: generación, implementación y posterior a la implementación. Cada sección proporciona una lista de errores asociados con la siguiente información para cada error:
- Código de error: El identificador asignado por Adobe Commerce para el mensaje de error
- Fase: indica si el error se produjo durante la fase de compilación, implementación o posterior a la implementación
- Paso: indica el paso en el escenario de implementación que puede devolver el error. Si la columna Step está en blanco, se trata de un error general que se puede devolver mediante varios pasos o durante las operaciones de preprocesamiento. Consulte Implementación basada en escenarios para obtener más información sobre los pasos de compilación, implementación y posterior a la implementación.
- Sugerencia: Proporciona instrucciones para solucionar y resolver el error
- Título (descripción del error): una descripción que resume la causa del error
- Tipo: indica si el error es un error crítico o una advertencia
Errores críticos
Los errores críticos indican un problema con la configuración del proyecto de Commerce en la infraestructura en la nube que provoca un error de implementación, por ejemplo, una configuración incorrecta, no admitida o faltante para la configuración requerida. Antes de poder implementar, debe actualizar la configuración para resolver estos errores.
Fase de compilación
./app/etc/env.php
/app/etc/env.php
. Compruebe los permisos del sistema de archivos.schema.yaml
./vendor/magento/ece-tools/config/schema.yaml
. Compruebe que el nombre de la variable de configuración sea correcto y esté definido..magento.env.yaml
./.magento.env.yaml
no es válido. Utilice un analizador de YAML para comprobar la sintaxis y corregir los errores..magento.env.yaml
./.magento.env.yaml
. Compruebe los permisos del archivo..schema.yaml
./vendor/magento/ece-tools/config/magento.env.yaml
. Compruebe los permisos de archivo y vuelva a implementar (magento-cloud environment:redeploy
)../app/etc/config.php
/app/etc/config.php
. Compruebe los permisos del sistema de archivos.composer.json
./composer.json
. Compruebe los permisos del archivo.composer.json
autoload
necesaria en el archivo composer.json
. Compare la sección de carga automática con el archivo composer.json
en la plantilla de Cloud y agregue la configuración que falta..magento.env.yaml
contiene una opción que no está declarada en el esquema o una opción configurada con un valor o fase no válidos./.magento.env.yaml
contiene una configuración no válida. Consulte el registro de errores para obtener información detallada./bin/magento module:enable --all
composer update
localmente. A continuación, confirme y envíe el archivo composer.lock
actualizado. Además, compruebe cloud.log
para obtener más información. Para obtener resultados de comandos más detallados, agregue la opción VERBOSE_COMMANDS: '-vvv'
al archivo .magento.env.yaml
./pub/errors/local.xml
/bin/magento setup:di:compile
cloud.log
para obtener más información. Agregar VERBOSE_COMMANDS: '-vvv'
a .magento.env.yaml
para obtener un resultado de comando más detallado.composer dump-autoload
composer dump-autoload
. Compruebe cloud.log
para obtener más información.Baler
para el agrupamiento de JavascriptSCD_USE_BALER
para comprobar que el módulo Baler está configurado y habilitado para el agrupamiento JS. Si no necesita el módulo Baler, establezca SCD_USE_BALER: false
./bin/magento setup:static-content:deploy
cloud.log
para obtener más información. Para obtener resultados de comandos más detallados, agregue la opción VERBOSE_COMMANDS: '-vvv'
al archivo .magento.env.yaml
.cloud.log
para obtener más información.init
cloud.log
para obtener más información.init
./init
. Compruebe los permisos del sistema de archivos../init/pub/static/
./init/pub/static
. Compruebe los permisos del sistema de archivos.DEPLOYED_MAGENTO_VERSION_FROM_GIT
esté configurada..magento.app.yaml
. Para la compatibilidad con pagos de Braintree, utilice una extensión oficial del Commerce Marketplace en su lugar.Implementar fase
server
o port
. Compruebe cloud.log
para obtener más información../app/etc/env.php
/app/etc/env.php
. Compruebe los permisos del sistema de archivos.schema.yaml
./vendor/magento/ece-tools/config/schema.yaml
. Compruebe que el nombre de la variable de configuración es correcto y que está definido..magento.env.yaml
./vendor/magento/ece-tools/config/schema.yaml
. Compruebe que el nombre de la variable de configuración es correcto y que está definido..magento.env.yaml
./.magento.env.yaml
. Compruebe los permisos del archivo..schema.yaml
/bin/magento maintenance:enable
cloud.log
para obtener más información. Para obtener resultados de comandos más detallados, agregue la opción VERBOSE_COMMANDS: '-vvv'
al archivo .magento.env.yaml
.DATABASE_CONFIGURATION
esté configurada correctamente.SESSION_CONFIGURATION
esté configurada correctamente. La configuración debe contener al menos el parámetro save
.SEARCH_CONFIGURATION
esté configurada correctamente. La configuración debe contener al menos el parámetro engine
.RESOURCE_CONFIGURATION
esté configurada correctamente. La configuración debe contener al menos connection
parámetro.SEARCH_CONFIGURATION
esté configurada correctamente y que el servicio Elasticsearch esté disponible.SEARCH_CONFIGURATION
para habilitar Elasticsearch y compruebe la configuración del servicio de Elasticsearch en el archivo services.yaml
./bin/magento setup:install
cloud.log
y install_upgrade.log
para obtener más información. Para obtener resultados de comandos más detallados, agregue la opción VERBOSE_COMMANDS: '-vvv'
al archivo .magento.env.yaml
.app:config:import
cloud.log
para obtener más información. Para obtener resultados de comandos más detallados, agregue la opción VERBOSE_COMMANDS: '-vvv'
al archivo .magento.env.yaml
./bin/magento setup:static-content:deploy
cloud.log
para obtener más información. Para obtener resultados de comandos más detallados, agregue la opción VERBOSE_COMMANDS: '-vvv'
al archivo .magento.env.yaml
.cloud.log
para obtener más información../pub/static/deployed_version.txt
. Compruebe los permisos del sistema de archivos./bin/magento setup:db-schema:split
cloud.log
para obtener más información. Para obtener resultados de comandos más detallados, agregue la opción VERBOSE_COMMANDS: '-vvv'
al archivo .magento.env.yaml
.var/view_preprocessed
./var/view_preprocessed
. Compruebe los permisos del sistema de archivos./var/credentials_email.txt
/var/credentials_email.txt
. Compruebe los permisos del sistema de archivos./bin/magento setup:upgrade
cloud.log
y install_upgrade.log
para obtener más información. Para obtener resultados de comandos más detallados, agregue la opción VERBOSE_COMMANDS: '-vvv'
al archivo .magento.env.yaml
./bin/magento cache:flush
cloud.log
para obtener más información. Para obtener resultados de comandos más detallados, agregue la opción VERBOSE_COMMANDS: '-vvv'
al archivo .magento.env.yaml
./bin/magento maintenance:disable
cloud.log
para obtener más información. Agregar VERBOSE_COMMANDS: '-vvv'
a .magento.env.yaml
para obtener un resultado de comando más detallado.php ./bin/magento cache:enable
php ./bin/magento cache:enable
se ejecuta solamente cuando se instaló Adobe Commerce, pero el archivo ./app/etc/env.php
estaba ausente o vacío al principio de la implementación. Compruebe cloud.log
para obtener más información. Agregar VERBOSE_COMMANDS: '-vvv'
a .magento.env.yaml
para obtener un resultado de comando más detallado.crypt/key
no existe en el archivo ./app/etc/env.php
ni en la variable de entorno de nube CRYPT_KEY
./app/etc/env.php
no está presente cuando comienza la implementación de Adobe Commerce o si el valor crypt/key
no está definido. Si migró la base de datos desde otro entorno, recupere el valor de la clave de cifrado de ese entorno. A continuación, agregue el valor a la variable de entorno de nube CRYPT_KEY de su entorno actual. Consulte Clave de cifrado de Adobe Commerce. Si quitó accidentalmente el archivo ./app/etc/env.php
, utilice el siguiente comando para restaurarlo a partir de los archivos de copia de seguridad creados a partir de una implementación anterior: ./vendor/bin/ece-tools backup:restore
Comando CLI .".magento.app.yaml
. Para la asistencia del Braintree, utilice una extensión oficial de pagos de Braintree del Commerce Marketplace.engine
. Si está configurada, elimine la opción o establezca el valor en "elasticsearch".Fase de implementación de Post
./app/etc/env.php
/app/etc/env.php
. Compruebe los permisos del sistema de archivos.schema.yaml
./vendor/magento/ece-tools/config/schema.yaml
. Compruebe que el nombre de la variable de configuración es correcto y que está definido..magento.env.yaml
./.magento.env.yaml
no es válido. Utilice un analizador de YAML para comprobar la sintaxis y corregir los errores..magento.env.yaml
.schema.yaml
/bin/magento cache:flush
cloud.log
para obtener más información. Agregar VERBOSE_COMMANDS: '-vvv'
a .magento.env.yaml
para obtener un resultado de comando más detallado.General
schema.yaml
.magento.env.yaml
./.magento.env.yaml
no es válido. Utilice un analizador de YAML para comprobar la sintaxis y corregir los errores..magento.env.yaml
./.magento.env.yaml
. Compruebe los permisos del archivo..schema.yaml
cloud.log
para obtener más información.cloud.log
para obtener más información.cloud.log
para obtener más información.cloud.log
para obtener más información.Errores de advertencia
Los errores de advertencia indican un problema con la configuración del proyecto de Commerce en la infraestructura en la nube, como ajustes de configuración incorrectos, obsoletos, no compatibles o faltantes para funciones opcionales que pueden afectar al funcionamiento del sitio. Aunque una advertencia no provoca un error de implementación, debe revisar los mensajes de advertencia y actualizar la configuración para resolverlos.
Fase de compilación
Implementar fase
bin/magento admin:user:create
.app/etc/env.php
o estaba vacío.cloud.log
para obtener más información.