O Que É GITHUB_REF_NAME?

GITHUB_REF_NAME é o nome curto e legível da branch ou tag que disparou a execução.

Enquanto GITHUB_REF é o ref completo, GITHUB_REF_NAME remove o prefixo e entrega apenas main, feature/login ou v1.2.0 - o que você geralmente quer para nomeação e condicionais.

Usos comuns

• Fazer deploy apenas quando o nome do ref é main
• Nomear um release com base na tag
• Fazer slugify da branch para uma URL de preview

Exemplo

Condicionar um job de deploy ao nome da branch.

if: ${{ github.ref_name == 'main' }}

Principais conclusões

• GITHUB_REF_NAME é o nome curto da branch/tag.
• Ele remove o prefixo refs/heads ou refs/tags.
• Ideal para condicionais e nomeação.

Guias relacionados