O Que É GITHUB_BASE_REF?
GITHUB_BASE_REF é o branch base (de destino) para o qual um pull request vai fazer merge - definido apenas para eventos pull_request.
GITHUB_BASE_REF informa a um workflow de PR para onde a mudança está indo, o que é útil para calcular diffs contra o branch base ou aplicar regras específicas de branch.
Usos comuns
- Fazer diff dos arquivos alterados contra o branch base
- Aplicar verificações mais rígidas para PRs em
main - Combinar com GITHUB_HEAD_REF para o contexto completo do PR
Observação
Calcular um diff contra a base geralmente exige o histórico completo, então defina fetch-depth: 0 no actions/checkout.
Principais conclusões
- GITHUB_BASE_REF é o branch de destino do PR.
- Definido apenas em eventos pull_request.
- Fazer diff contra ele exige fetch-depth: 0.
Guias relacionados
What Is GITHUB_HEAD_REF?GITHUB_HEAD_REF is the source branch of a pull request in GitHub Actions. Learn when it is set and how to use…
What Is fetch-depth?What is fetch-depth in CI checkouts? Learn how this setting controls how much Git history a job fetches, why…
What Is a Pull Request?What is a pull request? An explainer on how PRs propose changes, gather review, run CI checks, and serve as t…