Skip to main content

​
Troubleshooting

Use esta página para diagnosticar problemas comuns ao publicar uma aplicação.

​
Deploy fica pendente por muito tempo

O que fazer:
  • Atualize a página e confira se houve mudança de status.
  • Veja os logs do projeto.
  • Tente iniciar um novo deploy.
  • Se persistir, entre em contato com o suporte informando o nome do projeto.
Observação: o job de deploy tem timeout de 15 minutos por tentativa. Se estourar, o deploy tende a falhar e você verá o motivo nos logs.

​
Build falhou

Verifique:
  • Dependências foram incluídas corretamente.
  • Lockfiles estão presentes quando usados pelo projeto.
  • O comando de instalação em ambarks.json funciona localmente.
  • O projeto não depende de arquivos que ficaram fora do ZIP ou do repositório.
Mensagens comuns e causas prováveis:

​
Comando de start falhou

Verifique:
  • run.command em ambarks.json.
  • Script start no package.json, se for Node.js.
  • Arquivo de entrada, como main.py, server.js ou equivalente.
  • Variáveis de ambiente exigidas pela aplicação.
Mensagens comuns e causas prováveis:

​
Deploy conclui, mas site não abre

Verifique:
  • Porta interna configurada no projeto.
  • Porta usada pelo comando de start.
  • EXPOSE no Dockerfile, se houver.
  • Se a aplicação escuta em 0.0.0.0 (e não em 127.0.0.1).
Mensagens comuns e causas prováveis:

​
Variável de ambiente não aparece

Verifique:
  • Se a variável foi salva no projeto correto.
  • Se houve novo deploy após a alteração.
  • Se o nome da variável está igual ao esperado pelo código.
  • Se ela precisa estar disponível durante o build (use “Build arg”).

​
Repositório GitHub não publica

Verifique:
  • Se a conta GitHub está conectada.
  • Se o repositório ainda existe e você tem permissão.
  • Se a branch selecionada contém os arquivos do projeto.
  • Se o projeto privado continua acessível pela integração.