# Problemas de deploy

### 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).

{% hint style="info" %}
Se existir um `requestId`, `traceId` ou link de execução, inclua também.
{% endhint %}