O Que É um Build Trigger? O Que Inicia um Pipeline
Um build trigger é o evento ou regra que diz ao seu sistema de CI para iniciar uma execução de pipeline.
Um pipeline não roda por conta própria; algo tem que iniciá-lo. Esse algo é um trigger. O trigger mais comum é um push de código, mas pipelines também começam a partir de pull requests, agendamentos, botões manuais, chamadas de API e até a conclusão de outro pipeline. Escolher os triggers certos controla quando o trabalho acontece e quanto de compute você gasta.
Tipos comuns de trigger
- Push: um commit chega a uma branch.
- Pull request: um PR é aberto, atualizado ou reaberto.
- Agendamento: uma expressão cron dispara em horários definidos.
- Manual: alguém clica em "run" ou dispara o workflow.
- Externo: uma chamada de API, webhook ou pipeline upstream o dispara.
Filtrando triggers
Triggers geralmente aceitam filtros para que um pipeline só rode quando deve: só na branch main, só quando arquivos sob src/ mudam, ou só para tags. Bons filtros impedem que mudanças não relacionadas queimem build minutes.
Um exemplo rápido
No GitHub Actions, on: push: branches: [main] roda o workflow apenas para pushes na main, enquanto on: schedule: - cron: "0 6 * * *" adiciona uma execução diária às 6h. Você pode listar vários triggers sob um mesmo bloco on:.
Triggers e custo
Todo trigger que dispara consome tempo de runner. Filtros de path, filtros de branch e limites de concorrência impedem que triggers lancem execuções redundantes. Cancelar execuções substituídas em pushes rápidos é uma economia comum.
Manual vs automático
Triggers automáticos (push, PR) mantêm o feedback rápido. Triggers manuais servem para deploys e jobs pontuais em que um humano deve decidir quando ir. Muitas equipes os combinam: os testes rodam automaticamente, os releases rodam com um clique manual.
Principais conclusões
- Um trigger é o evento ou regra que inicia uma execução de pipeline.
- Push, pull request, agendamento, manual e externo são os tipos comuns.
- Filtros por branch, path ou tag evitam execuções desnecessárias e economizam minutos.