Solução de problemas de implantação do Adobe Commerce

Última atualização: 7 de março de 2025

Criado para:

  • Desenvolvedor

Implantações travadas e com falha no Adobe Commerce podem ser resolvidas usando a ferramenta Solução de problemas de implantação. Clique em cada pergunta para revelar a resposta em cada etapa da solução de problemas.

Etapa 1 - Verificar se o serviço está em execução

O Adobe Commerce está funcionando no serviço de infraestrutura em nuvem?

Implantação paralisada - o serviço de infraestrutura em nuvem do Adobe Commerce está ativo? Verifique a Adobe Commerce Cloud.

a. SIM - Continue na Etapa 2.
b. NÃO - manutenção ou paralisações globais. Verifique a duração estimada e as atualizações.

Etapa 2 - Verificar implantações em outros ambientes

Existem implantações em outros ambientes que estão bloqueando a implantação no ambiente existente?

Para obter uma lista de atividades em andamento, execute o comando a seguir usando a Magento-Cloud CLI (se você tiver sido adicionado apenas a um projeto de nuvem). Observação: verifique se você está usando a versão mais recente da CLI do Magento Cloud. Para obter as etapas, consulte Atualizar a CLI no guia do Commerce na Infraestrutura em Nuvem.

magento-cloud --state=in_progress

Para obter uma lista de atividades em andamento, execute o seguinte comando usando a Magento-Cloud CLI (se tiver sido adicionado a vários projetos):

magento-cloud -p <project-id or project-url> --state=in_progress

Para encontrar informações sobre uma atividade de implantação existente (consulte Verificando o log de implantação se a interface de nuvem tiver um erro de "log recortado"
para obter detalhes), execute este comando para obter um log em execução dessa atividade:

magento-cloud activity:log <activity-id> [OPTIONAL: <-p project-id or project-url>]

a. SIM - Solucionar problemas de outro ambiente que bloqueia a implantação no ambiente existente. Vá para Etapa 3.

b. NÃO - Solucionar problemas do ambiente atual. Vá para Etapa 3.

Etapa 3 - Verificar o SSH em todos os nós

SSH bem-sucedido para todos os nós?
a. SIM - Continue na Etapa 4.
b. NÃO - Enviar um tíquete de suporte.

Etapa 4 - Verificar todos os serviços em execução

Todos os serviços estão em execução?
a. SIM - Continue na Etapa 5.
b. NÃO - Enviar um tíquete de suporte.

Etapa 5 - Verificar a execução do Bitbucket

Usando Bitbucket?
a. SIM - Verificar status.bitbucket.com.
b. NÃO - Verifique os erros do log de implantação nos Logs de compilação e implantação. Vá para a Etapa 6.

Etapa 6 - Verificar códigos de erro

Código de erro relatado?
a. SIM - Continue na Etapa 7.
b. NÃO - Continue na Etapa 8.

Etapa 7 - 403 Erro proibido

403 Proibido?
a. SIM - Continue na Etapa 16.
b. NÃO - Continue na Etapa 9.

Etapa 8 - Verificar trabalhos cron em execução

Os trabalhos do cron estão em execução no momento? Faça logon por ssh na ramificação e execute ps aufxx |grep cron.
a. SIM - Faça logon por ssh na ramificação afetada (por exemplo, principal). Eliminar e desbloquear trabalhos cron. Isso eliminará as tarefas do cron e redefinirá o status. Execute php vendor/bin/ece-tools cron:kill e depois php vendor/bin/ece-tools cron:unlock. Se você estava em processo de mesclar um ambiente em outro, verifique se os dois ambientes estão executando crons.
b. NÃO - Continue na Etapa 17.

Etapa 9 - Erro de aplicativo implantável no cluster remoto

Não é possível carregar o aplicativo para o erro de cluster remoto?
a. SIM - Continue na Etapa 10.
b. NÃO - Continue na Etapa 11.

Etapa 10 - Verificar armazenamento suficiente

Armazenamento disponível ok?
a. SIM - Continue com a Etapa 11.
b. NÃO - Revise Gerenciar espaço em disco.

Etapa 11 - Verificar espaço em disco

_Não foi possível gravar o arquivo Aviso _?
a. SIM - Aumente o valor do disco em .magento.app.yaml e reimplante. Se isso não funcionar, envie um tíquete de suporte.
b. NÃO - Continue com a Etapa 12.

Etapa 12 - Erro de falha na reimplantação do ambiente

Erro de falha na reimplantação do ambiente?
a. SIM - Continue com a Etapa 13.
b. NÃO - Continue com a Etapa 8.

Etapa 13 - Verificar falha de atualização do Elasticsearch

Elasticsearch sendo atualizado ou implantado?
a. SIM - falha nas etapas de atualização do Elasticsearch. Consulte compatibilidade de software do Elasticsearch. Se a atualização do Elasticsearch ainda não funcionar, envie um tíquete de suporte. Observação: no Adobe Commerce na infraestrutura em nuvem, esteja ciente de que as atualizações de serviço não podem ser enviadas para o ambiente de produção sem aviso prévio de 48 horas úteis para nossa equipe de infraestrutura. Isso é necessário, pois precisamos garantir que tenhamos um engenheiro de suporte de infraestrutura disponível para atualizar sua configuração dentro do prazo desejado com tempo de inatividade mínimo para seu ambiente de produção. Portanto, 48 horas antes de quando suas alterações precisam estar em produção, envie um tíquete de suporte detalhando a atualização de serviço necessária e informando a hora em que deseja que o processo de atualização tenha início.
b. NÃO - Continue na Etapa 14.

Etapa 14 - Verificar limites de espaço

Sistema de arquivos sem inodes ou espaço?
a. SIM - Consulte Gerenciar espaço em disco.
b. NÃO - Continue na Etapa 15.

Etapa 15 - Erro de versão do Elasticsearch

Erro sobre as versões de Elasticseach?
a. SIM - Continue na Etapa 16.
b. NÃO - Continue na Etapa 21.

Etapa 16 - Verificar configuração do Composer

Configuração correta do compositor?
a. SIM - Continue na Etapa 10.
b. NÃO - Revise a página da Web de solução de problemas do Composer.

Etapa 17 - Verificar processos de longa execução

Processos de longa execução?

a. SIM - Identificar processos de longa duração e, em seguida, eliminar processos:

  1. Execute o seguinte comando no terminal: ps aufx.
  2. Localize o PID do processo de longa duração.
  3. Encerrar o processo usando kill -9 <PID>.

Monitore implantações para recorrência.

b. NÃO - Continue na Etapa 18.

Etapa 18 - Verificar falha do gancho de postagem

Falha/travamento do gancho de postagem?
a. SIM - Banco de Dados: Espaço livre em disco, corrompido, tabelas incompletas/corrompidas.
b. NÃO - Continue na Etapa 19.

Etapa 19 - Verificar se extensões de terceiros bloqueiam a implantação

Usando extensões de terceiros?
a. SIM - Tente desabilitar as extensões de terceiros e executar a implantação (para ver se elas são a causa do problema), especialmente se houver nomes de extensão em quaisquer erros.
b. NÃO - Continue na Etapa 20.