Documentação

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

Last update: Fri Dec 19 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

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.

Descrição description

Ambiente

Adobe Commerce na infraestrutura em nuvem

Problema/Sintomas

  • Implantação paralisada ou com falha em um ambiente
  • Implantações bloqueadas devido a atividades em andamento em outros ambientes
  • Problemas de acesso SSH a nós
  • Serviços que não estão em execução (por exemplo, Elasticsearch, cron, relacionado ao Composer)
  • Espaço em disco ou limites de inode insuficientes
  • Erros de versão/configuração do 403/Elasticsearch
  • Falhas no upload de cluster remoto ou erros de reimplantação
  • Processos de longa duração, falhas pós-gancho ou conflitos de extensão de terceiros
  • Consultas lentas e problemas no lado do banco de dados (MySQL)
  • Problemas de configuração do Composer ou restrições de patch

Resolução resolution

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

O serviço Adobe Commerce na infraestrutura em nuvem está ativo?

Implantação paralisada - o serviço de infraestrutura em nuvem do Adobe Commerce está ativo? Verifique a Adobe Commerce Cloud (em Experience Cloud na página Status do Adobe).

  • SIM - Vá para a Etapa 2.
  • 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 ver as etapas, consulte Atualizar a CLI no guia do Commerce na nuvem.

code language-none 
magento-cloud --state=in_progress

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

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

Para encontrar informações sobre uma atividade de implantação existente (consulte Verificação do log de implantação se a interface de usuário da nuvem tiver um erro de "log enviado" para obter detalhes), execute este comando para obter um log em execução dessa atividade.

code language-none 
magento-cloud activity:log <activity-id>[ OPTIONAL: <-p project-id or project-url>]
  • SIM - Solucionar problemas do outro ambiente que bloqueia a implantação. Vá para a Etapa 3.
  • NÃO - Solucionar problemas do ambiente atual. Vá para a Etapa 3.

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

SSH bem-sucedido em todos os nós?

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

Todos os serviços estão sendo executados?

Etapa 5 - Verificar a execução do Bitbucket

Usando o Bitbucket?

Etapa 6 - Verificar códigos de erro

Código de erro relatado?
  • SIM - Vá para a Etapa 7.
  • NÃO - Vá para a Etapa 8.

Etapa 7 - 403 Erro proibido

403 Proibido?
  • SIM - Vá para a Etapa 16.
  • NÃO - Vá para a Etapa 9.

Etapa 8 - Verificar trabalhos cron em execução

Os trabalhos cron estão em execução atualmente? Faça logon por SSH na ramificação e execute:
code language-none 
ps aufxx | grep cron

  • SIM - eliminar e desbloquear trabalhos cron:

    code language-none 
    php vendor/bin/ece-tools cron:kill

    php vendor/bin/ece-tools cron:unlock

  • NÃO - Vá para a 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?
  • SIM - Vá para a Etapa 10.
  • NÃO - Vá para a Etapa 11.

Etapa 10 - Verificar armazenamento suficiente

Armazenamento disponível, ok?

Etapa 11 - Verificar espaço em disco

O arquivo não pôde ser gravado. Aviso?

  • SIM -

    • Para ambientes de Integração/Início: aumente o valor do disco em .magento.app.yaml e reimplante. Se isso não funcionar, envie um tíquete de suporte. Como alternativa, exclua arquivos de log grandes:
    code language-none 
    ls -la var/log

  • NÃO - Continue na Etapa 12.

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

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

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

Elasticsearch sendo atualizado ou implantado?
  • 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 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 upgrade tenha início.
  • NÃO - Vá para a Etapa 14.

Etapa 14 - Verificar limites de espaço

Sistema de arquivos sem inodes ou espaço suficiente?

Etapa 15 - Erro de versão do Elasticsearch

Erro sobre as versões do Elasticsearch?
  • SIM - Vá para a Etapa 16.
  • NÃO - Vá para a Etapa 21.

Etapa 16 - Verificar configuração do Composer

A configuração do compositor está correta?

Etapa 17 - Verificar processos de longa execução

Processos de longa duração?

  • SIM - Eliminar processos:

    1. Executar: ps aufx
    2. Localizar PID
    3. Encerrar: kill -9 <PID>

  • NÃO - Vá para a Etapa 18.

Etapa 18 - Verificar falha do gancho de postagem

Falha/travamento do gancho de postagem?
  • SIM - Banco de dados: espaço em disco livre, corrompido, tabelas incompletas/corrompidas.
  • NÃO - Vá para a Etapa 19.

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

Usar extensões de terceiros?

Etapa 20 - Verificar consultas lentas

Consultas de longa duração?

Verificar log de consulta lenta e show processlist do MySQL.

Etapa 21 - Fazer downgrade da versão do Elasticsearch

Fazendo downgrade das versões do Elasticsearch?
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f