· DevOps · 2 min read
Por que seu pipeline funciona em STG mas quebra em PROD

“Em STG funciona, em PROD quebrou”
Se você trabalha com CI/CD, provavelmente já ouviu (ou disse) essa frase.
E quase sempre o problema não está no código.
Está no ambiente, no pipeline ou na forma como o deploy é feito.
O que normalmente está por trás desse problema
Na prática, vejo sempre os mesmos padrões:
- STG não representa PROD
- Variáveis diferentes (ou faltando)
- Secrets compartilhados
- Infra criada “na mão”
- Deploy em produção sem validação real
STG vira um “ambiente de testes bonito”,
mas não confiável.
Erro #1 — STG não é espelho de PROD
Quando STG é:
- menor
- simplificado
- sem as mesmas integrações
- sem as mesmas regras de rede/segurança
Ele não valida nada importante.
👉 STG precisa ser igual em arquitetura,
mesmo que menor em escala.
Erro #2 — Variáveis e secrets inconsistentes
Alguns exemplos clássicos:
- variável existe em STG e não em PROD
- secret diferente sem documentação
.envcopiado manualmente
Resultado:
o deploy sobe, mas o sistema quebra em runtime.
👉 Cada ambiente precisa de configuração explícita e versionada.
Erro #3 — Infra fora do controle
Quando a infraestrutura:
- não está em código
- não tem histórico
- foi ajustada no console
Você perde:
- previsibilidade
- rastreabilidade
- confiança
👉 Infra como Código (Terraform) não é luxo.
É pré-requisito para produção.
Erro #4 — Deploy em produção sem gate
Deploy automático em PROD sem aprovação é pedir problema.
Produção precisa de:
- build controlado
- etapa manual
- rollback definido
Automação sem controle não é maturidade.
Como evitar isso na prática (checklist rápido)
- STG espelha PROD em arquitetura
- Variáveis separadas por ambiente
- Secrets separados e documentados
- Infra criada via código
- Deploy PROD via tag
- Gate manual antes do deploy
- Rollback testado
Conclusão
Quando STG quebra e PROD também,
o problema não é azar.
É processo mal definido.
Pipeline bom é aquele que:
- falha cedo
- falha em STG
- não falha em produção
Se você sente que:
- não confia no seu STG
- tem medo de deployar
- resolve incidente “no improviso”
👉 Me chama no WhatsApp e descreve seu cenário.

