Por que usar tag no seu projeto

As tags no Git são ferramentas poderosas para marcar e organizar versões do seu código. Elas são essenciais para o processo de desenvolvimento e lançamento de software, facilitando a identificação e a recuperação de versões específicas do projeto. Use as tags anotadas para obter mais informações e as tags leves para marcações rápidas e simples. E não se esqueça de compartilhar suas tags com o repositório remoto para que toda a equipe tenha acesso às versões marcadas.

As tags no Git são usadas para marcar pontos específicos na história do repositório como importantes, geralmente para indicar releases de software (como v1.0, v2.0, etc.). Elas ajudam a identificar versões de código de forma clara e organizada.

Neste tutorial, vamos aprender a:

1. Listar tags existentes.
2. Criar novas tags.
3. Entender os tipos de tags.
4. Compartilhar tags com o repositório remoto (GitHub).

Listando Tags no Git

Para listar todas as tags disponíveis no seu repositório Git, use o comando:

bash
Copiar código
$ git tag

Este comando exibirá todas as tags em ordem alfabética. Para buscar tags específicas com um padrão, use:

bash
Copiar código
$ git tag -l "v1.8.5*"

Criando Tags

Existem dois tipos de tags no Git: Leves e Anotadas.

Tags Anotadas

As tags anotadas são recomendadas porque armazenam mais informações, como o autor, a data e uma mensagem. Para criar uma tag anotada, use o comando:

bash
Copiar código
$ git tag -a v1.4 -m "my version 1.4"

Para visualizar as informações da tag anotada, use:

bash
Copiar código
$ git show v1.4

Tags Leves

As tags leves são simples e apenas apontam para um commit específico, sem armazenar informações adicionais. Para criar uma tag leve, use:

bash
Copiar código
$ git tag v1.4-lw

Para visualizar a tag leve, use:

bash
Copiar código
$ git show v1.4-lw

Criando Tags Posteriormente

Se você esqueceu de criar uma tag em um commit específico, é possível adicioná-la depois. Primeiro, encontre o commit com o comando:

bash
Copiar código
$ git log --pretty=oneline

Depois, crie a tag apontando para o commit desejado:

bash
Copiar código
$ git tag -a v1.2 9fceb02

Compartilhando Tags com o GitHub

Por padrão, o comando git push não envia tags para o repositório remoto. Para compartilhar uma tag específica, use:

bash
Copiar código
$ git push origin v1.5

Para enviar todas as tags de uma vez, use:

bash
Copiar código
$ git push origin --tags

Verificando o Código de uma Tag

Embora não seja possível realizar o checkout de uma tag diretamente, você pode criar um novo branch a partir de uma tag:

bash
Copiar código
$ git checkout -b version2 v2.0.0

Isso cria um branch version2 baseado na tag v2.0.0, permitindo que você faça alterações sem modificar a tag original.