Skip to content
Latchkey

O Que É uma Aprovação Manual? Pausando um Pipeline para um Humano

Uma aprovação manual é uma pausa deliberada em um pipeline que espera um humano autorizar a continuação, tipicamente antes de fazer deploy em produção.

A automação é poderosa, mas algumas decisões devem permanecer com uma pessoa. Uma aprovação manual insere um gate que segura o pipeline até que um revisor autorizado clique em aprovar (ou rejeitar). É mais comum logo antes de um deploy em produção, onde um humano quer uma última olhada antes de as mudanças entrarem no ar.

Como um gate de aprovação funciona

Quando o pipeline chega ao gate, ele pausa e notifica os aprovadores. Nada downstream roda até que alguém aprove. Se a aprovação for rejeitada ou expirar, o pipeline para e o deploy nunca acontece.

Onde as aprovações se encaixam

Aprovações cabem melhor em transições de alto risco: promover um build para produção, liberar para todos os usuários ou aplicar mudanças de infraestrutura. Elas agregam pouco valor em steps de baixo risco como rodar testes unitários, onde uma pausa apenas atrasa o feedback.

Um exemplo rápido

No GitHub Actions, um job amarrado a um environment protegido com reviewers obrigatórios vai esperar no deploy job até que um reviewer o aprove na UI. O GitLab oferece jobs manuais e environments protegidos semelhantes.

Aprovações vs gates automatizados

  • Aprovação manual: um humano decide.
  • Quality gate: uma regra automatizada (cobertura, scan) decide.
  • Muitos pipelines usam ambos: gates automatizados filtram, humanos aprovam o release final.

Mantendo as aprovações rápidas

Uma aprovação que fica desatendida trava a entrega. Roteie notificações para as pessoas certas, defina timeouts sensatos e reserve aprovações para mudanças que realmente precisam de um humano, para que o gate proteja sem virar um gargalo.

Principais conclusões

  • Uma aprovação manual pausa um pipeline até que uma pessoa autorizada aprove.
  • É mais útil antes de deploys em produção e outros steps de alto risco.
  • Combine aprovações manuais com quality gates automatizados para controle em camadas.

Guias relacionados