Validação inteligente: pare de rodar scripts duas vezes no DevOps
Evite Execuções Duplas em Scripts: Validação Inteligente Antes de Rodar
Quem nunca passou por isso? Um script de deploy roda sem problemas, mas depois, por causa de um retry automático, um clique nervoso ou uma falha na pipeline, ele executa novamente. O resultado? Migrações duplicadas, recursos criados em dobro e webhooks disparando várias vezes.
É aí que entra a validação de estado antes da execução.
O Problema com a Suposição de Idempotência
Muita gente acha que seus scripts são idempotentes. Ou seja, rodar duas vezes deveria dar o mesmo resultado que rodar uma única vez. Na teoria funciona. Na prática, é arriscado.
Alguns exemplos comuns:
- Scripts que criam recursos na AWS
- Migrações que alteram o esquema do banco
- Handlers de webhook que processam cadastros
- Jobs que sincronizam dados entre sistemas
Mesmo que pareçam idempotentes, uma execução dupla pode gerar problemas. Um timestamp atualizado duas vezes, um contador que sobe além do esperado ou uma notificação enviada ao cliente por engano.
O erro está em confiar que isso nunca vai acontecer.
Validação Antes da Execução
Em vez de depender só da idempotência, times de DevOps modernos estão adotando o rastreamento explícito de execuções. Antes de rodar algo, a pergunta é simples: “Isso já executou nesse contexto?”
Frameworks de validação mantêm um registro de estado — seja por timestamps, hashes, flags no banco ou locks distribuídos. Esse registro responde se o script deve rodar ou não.
Como Funciona na Prática
- Consulta o histórico — Verifica se a operação já foi executada antes
- Valida o contexto — Confirma se os parâmetros são os mesmos
- Bloqueia ou marca — Sinaliza que está em andamento para evitar conflitos
- Executa — Roda a lógica de negócio
- Atualiza o estado — Marca como concluído
Essa abordagem transforma o script de algo que “espera” ser seguro para algo que “prova” que não foi executado ainda.
Por Que Isso Interessa para Hospedagem e Infraestrutura
Na área de hosting, mudanças de DNS não devem se propagar duas vezes. Provisionamento de SSL não pode duplicar. Registro de domínio precisa acontecer exatamente uma vez.
Pre-execution validation é essencial em cenários como:
Distributed Systems: Quando scripts rodam em vários servidores ou regiões, a validação evita que a mesma operação ocorra em diferentes nodes simultaneamente.
CI/CD Pipelines: Reexecutar um deploy falho? A validação evita duplicatas em infrastrutura.
Webhook Handlers: Se um serviço externo tenta reenviar um webhook, a validação identifica e ignora o duplicado.
Database Migrations: migrate up duas vezes geralmente é ok, but custom migration scripts podem causar problemas.