Mensagens de erro para ECE-Tools

Última atualização: 31 de janeiro de 2025

Criado para:

  • Desenvolvedor

Esta referência de mensagem de erro fornece informações para solucionar erros que podem ocorrer durante os processos de criação, implantação e pós-implantação do Adobe Commerce na infraestrutura em nuvem.

Todas as mensagens de erro críticas e de aviso que ocorrem durante a implantação são gravadas nos arquivos var/log/cloud.log e /var/log/cloud.error.log. O arquivo de log de erros da nuvem contém apenas erros da implantação mais recente. Um arquivo vazio indica uma implantação bem-sucedida sem erros.

No arquivo cloud.error.log, cada entrada é formatada como uma cadeia de caracteres JSON para facilitar a análise:

{"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"}

As mensagens de erro são categorizadas por um dos estágios de implantação: criação, implantação e pós-implantação. Cada seção fornece uma lista de erros associados com as seguintes informações para cada erro:

  • Código de erro: o identificador atribuído pela Adobe Commerce para a mensagem de erro
  • Estágio: indica se o erro ocorreu durante o estágio de compilação, implantação ou pós-implantação
  • Etapa: indica a etapa no cenário de implantação que pode retornar o erro. Se a coluna Etapa estiver em branco, o erro será um erro geral que pode ser retornado por várias etapas ou durante operações de pré-processamento. Consulte Implantação baseada em cenário para obter mais informações sobre as etapas de compilação, implantação e pós-implantação.
  • Sugestão: fornece orientação para solucionar e resolver o erro
  • Título (Descrição do erro): uma descrição que resume a causa do erro
  • Tipo: indica se o erro é um erro crítico ou um aviso

Erros Críticos

Erros críticos indicam um problema com a configuração do projeto Commerce na infraestrutura em nuvem que causa falha na implantação, por exemplo, configuração incorreta, não compatível ou ausente para as configurações necessárias. Antes de implantar, é necessário atualizar a configuração para resolver esses erros.

Fase de criação

Código de erroEtapa de criaçãoDescrição do erro (Título)Ação sugerida
2Não é possível gravar no arquivo ./app/etc/env.phpO script de implantação não pode fazer as alterações necessárias no arquivo /app/etc/env.php. Verifique as permissões do sistema de arquivos.
3Configuração não definida no arquivo schema.yamlConfiguração não definida no arquivo ./vendor/magento/ece-tools/config/schema.yaml. Verifique se o nome da variável de configuração está correto e definido.
4Falha ao analisar o arquivo .magento.env.yamlO formato de arquivo ./.magento.env.yaml é inválido. Use um analisador YAML para verificar a sintaxe e corrigir erros.
5Não é possível ler o arquivo .magento.env.yamlNão é possível ler o arquivo ./.magento.env.yaml. Verifique as permissões do arquivo.
6Não é possível ler o arquivo .schema.yamlNão é possível ler o arquivo ./vendor/magento/ece-tools/config/magento.env.yaml. Verifique as permissões do arquivo e reimplante (magento-cloud environment:redeploy).
7módulos de atualizaçãoNão é possível gravar no arquivo ./app/etc/config.phpO script de implantação não pode fazer as alterações necessárias no arquivo /app/etc/config.php. Verifique as permissões do sistema de arquivos.
8validate-configNão é possível ler o arquivo composer.jsonNão é possível ler o arquivo ./composer.json. Verifique as permissões do arquivo.
9validate-configO arquivo composer.json não tem a seção de carregamento automático necessáriaA seção autoload necessária está ausente do arquivo composer.json. Compare a seção de carregamento automático com o arquivo composer.json no modelo de Nuvem e adicione a configuração ausente.
10validate-configO arquivo .magento.env.yaml contém uma opção que não está declarada no esquema ou uma opção configurada com um valor ou estágio inválidoO arquivo ./.magento.env.yaml contém configuração inválida. Verifique o log de erros para obter informações detalhadas.
11módulos de atualizaçãoFalha no comando: /bin/magento module:enable --allTente executar composer update localmente. Em seguida, confirme e envie por push o arquivo composer.lock atualizado. Além disso, consulte o cloud.log para obter mais informações. Para obter uma saída de comando mais detalhada, adicione a opção VERBOSE_COMMANDS: '-vvv' ao arquivo .magento.env.yaml.
12apply-patchesFalha ao aplicar patch
13set-report-dir-nested-levelNão é possível gravar no arquivo /pub/errors/local.xml
14copy-sample-dataFalha ao copiar arquivos de dados de amostra
15compile-idFalha no comando: /bin/magento setup:di:compileVerifique o cloud.log para obter mais informações. Adicione VERBOSE_COMMANDS: '-vvv' a .magento.env.yaml para obter uma saída de comando mais detalhada.
16dump-autoloadFalha no comando: composer dump-autoloadFalha no comando composer dump-autoload. Verifique o cloud.log para obter mais informações.
17enfardadorFalha no comando para executar Baler para agrupamento de JavascriptVerifique a variável de ambiente SCD_USE_BALER para verificar se o módulo Baler está configurado e habilitado para agrupamento JS. Se você não precisar do módulo Baler, defina SCD_USE_BALER: false.
18compress-static-contentO utilitário necessário não foi encontrado (tempo limite, bash)
19deploy-static-contentFalha no comando /bin/magento setup:static-content:deployVerifique o cloud.log para obter mais informações. Para obter uma saída de comando mais detalhada, adicione a opção VERBOSE_COMMANDS: '-vvv' ao arquivo .magento.env.yaml.
20compress-static-contentFalha na compactação de conteúdo estáticoVerifique o cloud.log para obter mais informações.
21backup-data: conteúdo estáticoFalha ao copiar conteúdo estático para o diretório initVerifique o cloud.log para obter mais informações.
22backup-data: writable-dirsFalha ao copiar alguns diretórios graváveis para o diretório initFalha ao copiar diretórios graváveis na pasta ./init. Verifique as permissões do sistema de arquivos.
23Não é possível criar um objeto do agente de log
24backup-data: conteúdo estáticoFalha ao limpar o diretório ./init/pub/static/Falha ao limpar a pasta ./init/pub/static. Verifique as permissões do sistema de arquivos.
25Não é possível encontrar o pacote do ComposerSe você instalou a versão do aplicativo Adobe Commerce diretamente do repositório GitHub, verifique se a variável de ambiente DEPLOYED_MAGENTO_VERSION_FROM_GIT está configurada.
26validate-configRemova a configuração do módulo de Braintree Magento que não é mais suportada no Adobe Commerce e no Magento Open Source 2.4 e versões posteriores.O suporte para o módulo de Braintree não está mais incluído no Magento 2.4.0 e mais recente. Remova a variável CONFIG_STORES_DEFAULT_PAYMENT_BRAINTREE_CHANNEL da seção de variáveis do arquivo .magento.app.yaml. Para suporte ao pagamento de Braintree, use uma extensão oficial da Commerce Marketplace.

Implantar estágio

Código de erroImplantar etapaDescrição do erro (Título)Ação sugerida
101pré-implantação: cacheConfiguração de cache incorreta (porta ou host ausente)A configuração de cache não tem os parâmetros necessários server ou port. Verifique o cloud.log para obter mais informações.
102Não é possível gravar no arquivo ./app/etc/env.phpO script de implantação não pode fazer as alterações necessárias no arquivo /app/etc/env.php. Verifique as permissões do sistema de arquivos.
103Configuração não definida no arquivo schema.yamlConfiguração não definida no arquivo ./vendor/magento/ece-tools/config/schema.yaml. Verifique se o nome da variável de configuração está correto e se está definido.
104Falha ao analisar o arquivo .magento.env.yamlConfiguração não definida no arquivo ./vendor/magento/ece-tools/config/schema.yaml. Verifique se o nome da variável de configuração está correto e se está definido.
105Não é possível ler o arquivo .magento.env.yamlNão é possível ler o arquivo ./.magento.env.yaml. Verifique as permissões do arquivo.
106Não é possível ler o arquivo .schema.yaml
107pré-implantação: clean-redis-cacheFalha ao limpar o cache RedisFalha ao limpar o cache Redis. Verifique se a configuração do cache Redis está correta e se o serviço Redis está disponível. Consulte Configurar serviço Redis.
108pré-implantação: set-production-modeFalha no comando /bin/magento maintenance:enableVerifique o cloud.log para obter mais informações. Para obter uma saída de comando mais detalhada, adicione a opção VERBOSE_COMMANDS: '-vvv' ao arquivo .magento.env.yaml.
109validate-configConfiguração de banco de dados incorretaVerifique se a variável de ambiente DATABASE_CONFIGURATION está configurada corretamente.
110validate-configConfiguração de sessão incorretaVerifique se a variável de ambiente SESSION_CONFIGURATION está configurada corretamente. A configuração deve conter pelo menos o parâmetro save.
111validate-configConfiguração de pesquisa incorretaVerifique se a variável de ambiente SEARCH_CONFIGURATION está configurada corretamente. A configuração deve conter pelo menos o parâmetro engine.
112validate-configConfiguração de recurso incorretaVerifique se a variável de ambiente RESOURCE_CONFIGURATION está configurada corretamente. A configuração deve conter pelo menos o parâmetro connection.
113validate-config:elasticsuite-integridadeO ElasticSuite está instalado, mas o serviço Elasticsearch não está disponívelVerifique se a variável de ambiente SEARCH_CONFIGURATION está configurada corretamente e se o serviço Elasticsearch está disponível.
114validate-config:elasticsuite-integridadeO ElasticSuite está instalado, mas outro mecanismo de pesquisa é usadoO ElasticSuite está instalado, mas outro mecanismo de pesquisa está configurado. Atualize a variável de ambiente SEARCH_CONFIGURATION para habilitar o Elasticsearch e verifique a configuração do serviço Elasticsearch no arquivo services.yaml.
115Falha na execução da consulta ao banco de dados
116instalação-atualização: configuraçãoFalha no comando /bin/magento setup:installVerifique os cloud.log e install_upgrade.log para obter mais informações. Para obter uma saída de comando mais detalhada, adicione a opção VERBOSE_COMMANDS: '-vvv' ao arquivo .magento.env.yaml.
117install-update: config-importFalha no comando app:config:importVerifique o cloud.log para obter mais informações. Para obter uma saída de comando mais detalhada, adicione a opção VERBOSE_COMMANDS: '-vvv' ao arquivo .magento.env.yaml.
118O utilitário necessário não foi encontrado (tempo limite, bash)
119install-update: deploy-static-contentFalha no comando /bin/magento setup:static-content:deployVerifique o cloud.log para obter mais informações. Para obter uma saída de comando mais detalhada, adicione a opção VERBOSE_COMMANDS: '-vvv' ao arquivo .magento.env.yaml.
120compress-static-contentFalha na compactação de conteúdo estáticoVerifique o cloud.log para obter mais informações.
121deploy-static-content:generateNão é possível atualizar a versão implantadaNão é possível atualizar o arquivo ./pub/static/deployed_version.txt. Verifique as permissões do sistema de arquivos.
122clean-static-contentFalha ao limpar arquivos de conteúdo estático
123install-update: split-dbFalha no comando /bin/magento setup:db-schema:splitVerifique o cloud.log para obter mais informações. Para obter uma saída de comando mais detalhada, adicione a opção VERBOSE_COMMANDS: '-vvv' ao arquivo .magento.env.yaml.
124clean-view-preprocessedFalha ao limpar a pasta var/view_preprocessedNão é possível limpar a pasta ./var/view_preprocessed. Verifique as permissões do sistema de arquivos.
125install-update: reset-passwordFalha ao atualizar o arquivo /var/credentials_email.txtFalha ao atualizar o arquivo /var/credentials_email.txt. Verifique as permissões do sistema de arquivos.
126install-update: updateFalha no comando /bin/magento setup:upgradeVerifique os cloud.log e install_upgrade.log para obter mais informações. Para obter uma saída de comando mais detalhada, adicione a opção VERBOSE_COMMANDS: '-vvv' ao arquivo .magento.env.yaml.
127clean-cacheFalha no comando /bin/magento cache:flushVerifique o cloud.log para obter mais informações. Para obter uma saída de comando mais detalhada, adicione a opção VERBOSE_COMMANDS: '-vvv' ao arquivo .magento.env.yaml.
128disable-maintenance-modeFalha no comando /bin/magento maintenance:disableVerifique o cloud.log para obter mais informações. Adicione VERBOSE_COMMANDS: '-vvv' a .magento.env.yaml para obter uma saída de comando mais detalhada.
129install-update: reset-passwordNão é possível ler o modelo de redefinição de senha
130install-update: cache_typeFalha no comando: php ./bin/magento cache:enableO comando php ./bin/magento cache:enable é executado somente quando o Adobe Commerce foi instalado, mas o arquivo ./app/etc/env.php estava ausente ou vazio no início da implantação. Verifique o cloud.log para obter mais informações. Adicione VERBOSE_COMMANDS: '-vvv' a .magento.env.yaml para obter uma saída de comando mais detalhada.
131install-updateO valor da chave crypt/key não existe no arquivo ./app/etc/env.php ou na variável de ambiente de nuvem CRYPT_KEYEste erro ocorre se o arquivo ./app/etc/env.php não estiver presente quando a implantação do Adobe Commerce começar ou se o valor crypt/key estiver indefinido. Se você migrou o banco de dados de outro ambiente, recupere o valor da chave de criptografia desse ambiente. Em seguida, adicione o valor à variável de ambiente de nuvem CRYPT_KEY no ambiente atual. Consulte Chave de criptografia do Adobe Commerce. Se você tiver removido acidentalmente o arquivo ./app/etc/env.php, use o seguinte comando para restaurá-lo dos arquivos de backup criados de uma implantação anterior: comando da CLI ./vendor/bin/ece-tools backup:restore."
132Não é possível conectar-se ao serviço ElasticsearchVerifique se há credenciais de Elasticsearch válidas e se o serviço está em execução
137Não é possível conectar ao serviço OpenSearchVerifique se há credenciais OpenSearch válidas e se o serviço está em execução
133validate-configRemova a configuração do módulo de Braintree Magento que não é mais suportada no Adobe Commerce ou Magento Open Source 2.4 e versões posteriores.O suporte para o módulo de Braintree não está mais incluído no Adobe Commerce ou Magento Open Source 2.4.0 e posteriores. Remova a variável CONFIG_STORES_DEFAULT_PAYMENT_BRAINTREE_CHANNEL da seção de variáveis do arquivo .magento.app.yaml. Para suporte a Braintree, use uma extensão oficial de Pagamentos de Braintree do Commerce Marketplace.
134validate-configO Adobe Commerce e o Magento Open Source 2.4.0 exigem a instalação do serviço de ElasticsearchInstalar serviço de Elasticsearch
138validate-configO Adobe Commerce e o Magento Open Source 2.4.4 exigem a instalação do serviço OpenSearch ou ElasticsearchInstalar serviço OpenSearch
135validate-configO mecanismo de pesquisa deve ser definido como Elasticsearch para Adobe Commerce e Magento Open Source >= 2.4.0Verifique a variável SEARCH_CONFIGURATION para a opção engine. Se estiver configurado, remova a opção ou defina o valor como "elasticsearch".
136validate-configO banco de dados dividido foi removido a partir do Adobe Commerce e do Magento Open Source 2.5.0.Se você usar o banco de dados dividido, será necessário reverter para um único banco de dados ou migrar para ele, ou usar uma abordagem alternativa.
139validate-configMecanismo de pesquisa incorretoEsta versão do Adobe Commerce ou Magento Open Source não é compatível com OpenSearch. Você deve usar o versões 2.3.7-p3, 2.4.3-p2 ou posterior