O Que É uma Release Tag?

Uma release tag é uma Git tag, geralmente um número de versão, que marca o commit exato entregue como um release específico.

Uma release tag transforma um commit em uma versão nomeada. Quando uma equipe decide que um commit está pronto para entrega, ela o marca com algo como v2.1.0. Essa tag se torna a referência permanente para aquele release e, na maioria dos pipelines, o sinal para fazer o build e publicá-lo.

O que torna uma tag uma release tag

Tecnicamente uma release tag é uma tag comum; o que a torna uma release tag é convenção e intenção. Ela nomeia um commit que passou por todos os checks e é destinado aos usuários. Tags anotadas, frequentemente assinadas, são preferidas para que o release carregue um autor, data e mensagem.

Versionamento semântico

A maioria das release tags segue um esquema major.minor.patch. Os números comunicam a natureza da mudança num relance.

git tag -a v2.1.0 -m "Add export API; fix pagination"
git push origin v2.1.0

Por que release tags importam

Uma release tag dá a todos, humanos e máquinas, uma referência inequívoca de uma versão entregue. O suporte pode reproduzir o build exato que um usuário está rodando, e rollbacks podem mirar uma tag anterior com confiança. A tag é o contrato do que "versão 2.1.0" significa.

Release tags em CI/CD

Pipelines de release comumente disparam com uma tag de versão enviada. O workflow faz o build do artefato a partir do commit com tag, executa os checks finais, publica em um registry e rascunha as notas de release. Como a tag é imutável, o artefato publicado fica atrelado a um estado de fonte exato e reproduzível.

Dicas de release tagging

• Marque apenas commits que passaram no CI e estão realmente prontos para entrega.
• Adote o versionamento semântico para números de versão previsíveis.
• Automatize builds de release a partir de eventos de push de tag.
• Assine release tags quando a proveniência importa.

Principais conclusões

• Uma release tag marca o commit exato entregue como uma versão.
• O versionamento semântico torna os números de versão significativos.
• Release tags enviadas comumente disparam pipelines de build-and-publish.

Guias relacionados