Criando uma Tag e um Release no Git & GitHub

Postado em 05/04/2025

Por Lorenzo Uriel - Cylogus

2 min de leitura

Git não se trata apenas de branches. Às vezes, precisamos lançar versões.

Existem dois conceitos-chave para isso: tags e releases.

Usar esses recursos de forma eficiente pode melhorar tanto a qualidade do código quanto a organização do repositório.

Como isso pode te ajudar?

Tags marcam pontos específicos na história do repositório, servindo como referência para versões importantes do projeto.
Releases são construídas a partir das tags, adicionando metadados como notas de lançamento (release notes), binários e documentação sobre a nova versão.

Isso facilita o controle e o lançamento de atualizações.

Criando uma Tag

O Git suporta dois principais tipos de tags:

Para criar uma annotated tag, use o seguinte comando:

  
git tag -a v1.0.0 -m "First Release"

Para criar uma lightweight tag, use:

git tag v1.0.0

Cada número na versão tem seu próprio significado e importância. Aqui vai uma explicação simples e prática:

Major: Mudanças incompatíveis com versões anteriores (Reestruturou tudo? Some +1 — v2.0.0)
Minor: Mudanças compatíveis com a versão anterior, mas com novas funcionalidades (Adicionou uma nova feature? Some +1 — v2.1.0)
Correction (Patch): Correções de bugs sem impacto na compatibilidade (Corrigiu um erro? Some +1 — v2.1.1)
Build: Controle interno de versionamento, nem sempre visível na versão final.

Listando todas as tags do repositório:

git tag

Por padrão, o git push não envia tags. Para enviar uma tag específica:

git push origin v1.0.0

Para enviar todas as tags:

git push origin --tags

Vá até o repositório no GitHub.
Clique na aba Releases.
Clique em “Create a new release”.
Selecione a tag que foi enviada para o repositório, adicione as release notes descrevendo as mudanças e o título da versão. Para finalizar, clique em “Publish release”.
O GitHub irá gerar os arquivos binários e compilados automaticamente.
Todas as releases ficarão disponíveis no seu projeto.