Problemas de deploy

Deploy falhando, travado, ou com app fora do ar após publicar.

Quando usar

• Deploy falha com erro.

• Deploy fica em progresso e não termina.

• Deploy conclui, mas a aplicação não sobe.

Checklist rápido (2 min)

1. Confirme o ambiente correto (Dev/Staging/Prod).

2. Rode um novo deploy. Evite “spam deploy”.

3. Verifique se houve mudança recente de variáveis/segredos.

Diagnóstico

1) O erro é de build ou de runtime?

• Build: falha antes de publicar artefatos.

• Runtime: publica, mas cai na inicialização ou em endpoints.

2) Configuração de ambiente

• Variáveis obrigatórias estão setadas?

• Integrações (API keys) existem no ambiente correto?

3) Dependências externas

• Banco acessível?

• Webhooks e serviços terceiros respondem?

Como resolver (padrões)

• Build quebrou: rever mudanças recentes e reverter o último delta.

• Runtime caiu: checar logs do app e falha no start.

• Erro intermitente: confirmar limites (rate limit), timeout, e dependências.

Quando escalar

• Erro 5xx no pipeline repetível.

• Deploy travado por mais de 20 min.

• App com downtime em Staging/Prod.

Antes de escalar, junte estas evidências. Isso reduz muito o ping-pong.

• Projeto e ambiente (Dev/Staging/Prod).

• Horário do erro (com timezone).

• Passos para reproduzir (curto e determinístico).

• Mensagem de erro completa (sem prints cortados).

• Screenshot da tela (se aplicável).

• Console do browser (erros e warnings relevantes).

• Aba Network (request que falhou + status + payload, se não houver dados sensíveis).

Se existir um requestId, traceId ou link de execução, inclua também.