O Que É um Gatilho de Workflow no GitHub Actions?
Um gatilho é o evento que faz um workflow executar. Você lista os gatilhos no bloco on: do workflow.
Um workflow não faz nada até que algo o dispare. Os gatilhos conectam a atividade do repositório, agendamentos e ações manuais à sua automação por meio da chave on:.
O que é
Um gatilho é um evento que o workflow escuta. O GitHub suporta dezenas deles, desde pushes de código e pull requests até comentários em issues, releases, agendamentos e disparo manual.
on:
push:
branches: [main]
pull_request:
schedule:
- cron: '0 6 * * *'
workflow_dispatch:Como funciona
Quando uma atividade ocorre, o GitHub verifica o bloco on: de cada workflow. Se o evento e seus filtros (branches, paths, tags) corresponderem, o GitHub cria um workflow run.
Filtrando gatilhos
Muitos gatilhos aceitam filtros para que você execute apenas quando importa: branches específicas, paths de arquivos alterados ou padrões de tag. Isso evita desperdiçar minutos de runner em mudanças irrelevantes.
Por que importa
Escolher os gatilhos certos controla quando a automação executa, o que afeta diretamente a velocidade do feedback e o custo. Gatilhos amplos demais queimam minutos; gatilhos restritos demais perdem eventos importantes.
Conceitos relacionados
Gatilhos comuns incluem push, pull_request, schedule e workflow_dispatch, cada um com suas próprias opções de filtragem.
Principais conclusões
- Gatilhos são eventos declarados sob
on:. - Eles podem ser filtrados por branch, path ou tag.
- A escolha do gatilho controla a velocidade do feedback e o custo.