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?

SIM - Vá para a Etapa 4.
NÃO - Enviar um tíquete de suporte.

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

Todos os serviços estão sendo executados?

SIM - Vá para a Etapa 5.
NÃO - Enviar um tíquete de suporte.

Etapa 5 - Verificar a execução do Bitbucket

Usando o Bitbucket?

SIM - Verificar status.bitbucket.com.
NÃO - Verifique os erros do log de implantação nos logs de Compilar e Implantar. Vá para a Etapa 6.

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?

Verificar ambiente de Integração/Início
Verificar ambiente de Preparo/Produção Profissional
SIM - Continue na Etapa 11.
NÃO - Revise Gerenciar espaço em disco.

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`

Para ambientes de Produção/Preparo Profissional: Envie um tíquete de suporte para adicionar armazenamento.

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?

SIM - Consulte Gerenciar espaço em disco.
NÃO - Vá para a Etapa 15.

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?

SIM - Vá para a Etapa 10.
NÃO - Examine a página da Web de Solução de Problemas do Compositor.

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?

SIM - Tente desabilitar as extensões de terceiros e reimplantar, especialmente se houver nomes de extensão em quaisquer erros.
NÃO - Vá para a Etapa 20.

Etapa 20 - Verificar consultas lentas

Consultas de longa duração?

Verificar log de consulta lenta e show processlist do MySQL.

SIM - Elimine consultas de longa execução. Revise MySQL Kill.
NÃO - Enviar um tíquete de suporte.

Etapa 21 - Fazer downgrade da versão do Elasticsearch

Fazendo downgrade das versões do Elasticsearch?

SIM - Não pode ser feito por meio de configuração. Enviar um tíquete de suporte.
NÃO - Enviar um tíquete de suporte.

recommendation-more-help

3d58f420-19b5-47a0-a122-5c9dab55ec7f