Falha na implantação com "Erro ao criar projeto: o gancho de criação falhou com o código de status 1"

Última atualização: 3 de dezembro de 2024

Criado para:

  • Desenvolvedor

Este artigo fala sobre as causas e soluções do problema de infraestrutura na nuvem do Adobe Commerce, em que a fase de compilação do processo de implantação falha, e a mensagem de erro é resumida com: "Erro ao compilar o projeto: O gancho de compilação falhou com o código de status 1".

Produtos e versões afetados

  • Adobe Commerce na infraestrutura em nuvem, todas as versões

Problema

Etapas a serem reproduzidas:

Acione a implantação manualmente ou executando uma mesclagem, push ou sincronização do seu ambiente.

Resultado esperado:

A implantação foi concluída com êxito.

Resultado real:

  1. A fase de criação falha e todo o processo de implantação fica paralisado.
  2. No log de erros de implantação, a mensagem de erro termina com: "Projeto de compilação de erro: falha do gancho de compilação com o código de status 1. Compilação anulada".

Causa

Há vários motivos pelos quais a criação de ambientes falha. Normalmente, no log de implantação, você verá uma mensagem de erro longa, em que a primeira parte seria mais específica em relação ao motivo, e a conclusão seria "Erro ao compilar o projeto: o gancho de compilação falhou com o código de status 1. Compilação anulada".

Analisar de perto a primeira parte específica do problema ajudará você a identificar o problema. Estas são as mais comuns e a próxima seção fornece soluções para elas:

  • Não há espaço de armazenamento disponível.
  • Configuração ECE-Tools incorreta.
  • O patch que você está tentando aplicar é incompatível com sua versão do Adobe Commerce ou está em conflito com outros patches aplicados ou com suas personalizações.
  • Problemas com o código de módulos personalizados estão impedindo a criação com êxito.

Solução

  • Verifique se há armazenamento suficiente. Para obter informações sobre como verificar o espaço disponível, consulte o artigo Verificar espaço em disco no ambiente de nuvem usando a CLI. Você pode considerar limpar os diretórios de log e/ou aumentar o espaço em disco.
  • Verifique se as ECE-Tools estão configuradas corretamente.
  • Verifique se é o patch que está causando o problema. Resolva o conflito ou contate o Suporte da Adobe Commerce. Consulte abaixo para obter detalhes.
  • Verifique se é a extensão personalizada que está causando o problema. Resolva o conflito ou entre em contato com os desenvolvedores de extensão para obter a solução.

Os parágrafos a seguir fornecem mais detalhes.

Limpar logs e/ou aumentar espaço

Diretórios a serem considerados para limpeza:

  • var/log
  • var/report
  • var/debug/
  • var

Para obter detalhes sobre como aumentar o espaço em disco se você estiver na arquitetura de plano inicial do Adobe Commerce na infraestrutura de nuvem, consulte o Aumentar espaço em disco para o ambiente de Integração na nuvem. As mesmas instruções podem ser usadas para aumentar o espaço do Adobe Commerce no ambiente de integração da arquitetura de plano Pro da infraestrutura em nuvem. Para Produção/Preparo Profissional, você precisa registrar um tíquete no Suporte da Adobe Commerce e solicitar mais espaço em disco. Mas é monitorado pela Platform. Mas, normalmente, você não precisará lidar com isso na arquitetura Preparação/Produção da Pro, pois o Adobe Commerce monitora esses parâmetros para você e o alerta e/ou executa ações de acordo com o contrato.