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.