git tag

git tag: criar uma tag para um commit do Git

O comando git tag serve para criar tags no seu repositório Git. As tags são como rótulos ou marcos que você pode usar para marcar pontos importantes no histórico do projeto, como versões de release (v1.0.0, v2.0.0). Elas se parecem com branches, mas não podem ser movidas depois de criadas — são pontos fixos.

Criar tags não altera o repositório em si (os commits tagueados continuam idênticos). Em vez disso, elas ajudam a trazer mais contexto e marcos para o desenvolvimento do projeto, facilitando para equipes e colaboradores acompanhar o progresso, voltar a versões estáveis e entender o histórico de mudanças. As tags também são úteis para automação de build ou de release, já que as ferramentas podem usá-las para identificar qual release empacotar ou implantar.

As tags no Git são de dois tipos:

• Tags leves (lightweight tags) são ponteiros simples para commits específicos. Elas servem principalmente para referenciar commits com nomes fáceis de ler.

• Tags anotadas (annotated tags) são armazenadas como objetos completos no banco de dados do Git, incluindo o nome de quem criou a tag, o e-mail, a data e a mensagem da tag. Elas podem ser assinadas com GPG e verificadas para garantir segurança e confiança. Essas tags são as recomendadas para marcar versões oficiais de release, porque carregam informações adicionais.

Exemplos

git tag -a v1.0.0 -m "Release version 1.0.0"

git tag v1.0.1

git tag

git tag -d v1.0.1

git push origin --tags

git push origin v1.0.0