Pular para o conteúdo principal

Problemas comuns

Comece sempre pela mesma pergunta: em que etapa parou? O estado da publicação já elimina metade das causas possíveis.

A publicação falha em Construindo​

O problema está no build da imagem. Abra Logs → Build e escolha a publicação.

No logCausaO que fazer
Dockerfile: no such file or directoryA pasta publicada não tem DockerfileCorrija a pasta na origem do projeto
Falha de autenticação ao buscar o códigoRepositório privado sem token de acessoInforme um token em Origem, no projeto
Erro de dependênciaDiferença entre a sua máquina e um build limpoFixe versões; o build não reaproveita o que existe localmente
Falta de memória durante o buildBuild pesado demaisReduza etapas, use imagem base menor ou build em múltiplos estágios

A aplicação não fica pronta​

O build passou, mas a aplicação não ficou pronta — não aceitou conexão na porta do serviço. A publicação falha com o motivo, e na tela do deployment a etapa Respondendo aparece como falha, com o problema e a ação. O mesmo código aparece na API e na CLI:

CódigoO que a tela dizO que fazer
APPLICATION_NOT_STARTEDA aplicação não chegou a iniciarPublique de novo. Se o motivo voltar, fale com quem administra a plataforma: a imagem não pôde ser baixada, o ambiente recusou criar o processo ou faltou capacidade — nada disso se corrige na aplicação
APPLICATION_CRASHED_ON_STARTA aplicação parou logo depois de iniciarVeja as últimas linhas em Logs → Runtime
HEALTH_CHECK_FAILEDA aplicação iniciou, mas não respondeuFaça a aplicação escutar em 0.0.0.0, na porta da variável PORT

Antes de falhar, a linha do tempo narra a espera — "A aplicação iniciou, mas ainda não aceita conexão na porta 8080.", por exemplo. Motivos definitivos encerram em cerca de 30 segundos; os demais, no prazo de 5 minutos.

O que olhar, em ordem:

  1. A porta. A aplicação precisa escutar em 0.0.0.0, na porta indicada pela variável PORT — não em localhost, nem numa porta fixa. EXPOSE no Dockerfile não muda a porta. É a causa mais comum.
  2. A inicialização. Abra Logs → Runtime: uma exceção na subida aparece ali.
  3. Configuração faltando. Uma variável ou secret ausente costuma derrubar a aplicação no início. Ver Configuração.
  4. Escrita em disco. O sistema de arquivos é somente leitura, exceto /tmp. Gravar fora dali falha — e, se acontece na subida, costuma derrubar a aplicação. Ver Como a aplicação roda.
  5. Recursos. Memória máxima baixa demais derruba a aplicação durante a subida. Ver Recursos e limites.

Nada foi trocado: a versão anterior continua atendendo. Se precisar de tempo para investigar, não há urgência de restaurar nada.

Cliquei em Publicar e nada aparece na lista​

A falha aconteceu antes de haver uma versão comprometida — por exemplo, repositório inacessível ou branch inexistente.

Abra Tentativas de publicação, no projeto: é onde essas ficam registradas, com o motivo.

O endereço não responde​

VerifiqueOnde
A publicação chegou a Online?Deployments
Houve uma troca de endereço? O anterior deixa de responder quando o novo fica no arDomínios, no projeto
HTTPS e roteamento foram confirmados?Domínios, no projeto
A aplicação está de pé?Serviços — réplicas prontas
A aplicação está respondendo?Logs → Runtime

Se você usa domínio próprio, confira também o estado da zona: uma zona que ainda não está Pronta não serve endereço.

A publicação ficou em 3 de 4 etapas​

É o normal logo depois de publicar. A última etapa, Endereço confirmado, só é marcada quando uma requisição real chega pela internet e a aplicação a responde. Abra o endereço no navegador: a partir da primeira resposta, a escada vai a 4 de 4 e mostra Recebendo tráfego.

Se você abriu o endereço e a escada não avançou, veja O endereço não responde: uma resposta gerada pela plataforma quando não alcança a aplicação, como um 503, não conta como prova.

A aplicação está no ar, mas com erro​

  1. Observabilidade → Rotas mostra qual rota concentra o erro. Uma taxa de 2% no total pode ser 100% em uma rota específica.
  2. Logs → Runtime mostra o que a aplicação escreveu no momento.
  3. Se o erro começou depois de uma publicação, restaure a versão anterior e investigue com calma.

Alterei uma variável e nada mudou​

Configuração passa a valer na próxima publicação. A tela avisa quando há mudança declarada e não aplicada.

Se você publicou e ainda assim o valor antigo persiste, veja a herança: o mesmo nome declarado em um escopo mais específico vence. A página de variáveis mostra a cadeia inteira e qual valor é o efetivo.

O log de runtime não mostra nada​

Três causas, em ordem de frequência:

  1. Ainda não há aplicação executando — a tela diz isso explicitamente, e é diferente de lista vazia.
  2. A aplicação escreve em arquivo, não em stdout/stderr.
  3. O período selecionado não cobre o momento do problema.

Um projeto não alcança o serviço de outro​

VerifiqueOnde
Os dois projetos têm um ambiente na mesma rede?Rede do projeto, nos dois
O projeto que chama foi autorizado para aquele serviço, e a permissão está Liberado?Rede do projeto, no projeto chamado
A chamada usa o nome interno e a porta do serviço?Endereços internos deste projeto, no projeto chamado
O serviço é uma aplicação web ou um serviço interno? Processo contínuo e tarefa agendada não recebem conexãoServiços

Resolver o nome não quer dizer alcançar: sem permissão, o nome resolve e a conexão não completa. Ver Rede entre projetos.

Uma tela diz que a capacidade não existe​

Não é erro seu e não há o que configurar: aquela capacidade não está disponível nesta instalação. A tela diz o que a plataforma não faz, sem prometer prazo. Ver O que já existe.

A zona de domínio próprio não confirma​

O console mostra o diagnóstico exato. A causa mais comum é o campo de nome no painel do provedor: alguns querem apenas apps, outros querem apps.acme.com.br inteiro. Ver Delegar no seu provedor.

Quando pedir ajuda​

Tenha em mãos:

  • o projeto e o endereço da publicação (a URL da página do deployment);
  • em que estado ela parou;
  • o trecho relevante do log — build ou runtime, conforme a etapa.

Com esses três itens, o suporte enxerga a mesma evidência que você.

Próximos passos​