Git tag

No Git, as tags (git tag) são usadas para marcar pontos específicos na história do seu repositório. Elas são frequentemente usadas para marcar releases importantes ou versões estáveis do seu software. Aqui estão os conceitos básicos e como você pode trabalhar com tags no Git:

Cria

Existem dois tipos principais de tags no Git: lightweight tags e annotated tags.

Lightweight

Um lightweight tag é basicamente um ponteiro para um commit específico, sem metadados adicionais. Para criar um lightweight tag, você simplesmente especifica um nome para a tag:

git tag nome_da_tag

Por exemplo:

git tag v1.0.0

Annotated

Um annotated tag é armazenado como um objeto Git completo, que inclui informações como o nome do autor, a data e uma mensagem de tag. Para criar um annotated tag, use a opção -a com o git tag, seguido de um nome para a tag:

git tag -a nome_da_tag -m "Mensagem da tag"

Por exemplo:

git tag -a v1.0.0 -m "Primeira versão estável"

Lista

Para listar todas as tags no repositório, você pode usar o seguinte comando:

git tag

Isso irá listar todas as tags em ordem alfabética.

Exibe Informações

Para exibir informações detalhadas sobre uma tag específica, como a mensagem associada a um annotated tag, use o seguinte comando:

git show nome_da_tag

Por exemplo:

git show v1.0.0

Publica

Por padrão, as tags criadas localmente não são enviadas para um repositório remoto durante git push. Para enviar tags específicas para um repositório remoto, você pode usar:

git push origin nome_da_tag

Para enviar todas as tags locais que ainda não foram enviadas para o repositório remoto, você pode usar:

git push origin --tags

Exclui

Para excluir uma tag localmente, use o comando git tag -d seguido pelo nome da tag:

git tag -d nome_da_tag

Para excluir uma tag remota, use:

git push origin --delete nome_da_tag

Utilizações Comuns

• Marcar Releases: Usar tags para marcar versões específicas de seu software (por exemplo, v1.0.0, v1.1.0).

• Pontos de Referência: Facilitar a referência rápida a pontos importantes do histórico do seu projeto.

• Compartilhar Releases: Facilitar a distribuição de versões estáveis para colaboradores ou para o público em geral.

As tags são uma ferramenta poderosa para gerenciar o fluxo de versões e releases em seu projeto Git, ajudando a identificar e marcar pontos importantes no desenvolvimento do software.

Laboratório

Cria

$ git branch
  feature-1
  feature-2
* main
$ git tag
$ git tag -a v2.0 -m "Versão 2.0"
$ git tag
v2.0

$ git log
commit aae07ff1e1185c16634cc0949ef03e7f94ca023e (HEAD -> main, tag: v2.0)
Author: Marcelo de Paiva Barbieri <[e-mail]>
Date:   Fri Aug 2 11:09:11 2024 -0300

    Arquivo main.txt

commit f0ccc3bb4d5516d321c8b5768b769dde8bf0b290
Author: Marcelo de Paiva Barbieri <[e-mail]>
Date:   Fri Aug 2 10:35:12 2024 -0300

    Primeiro Commit

$ git tag -a v1.0 -m "Versão 1.0" f0ccc3bb4d5516d321c8b5768b769dde8bf0b290
$ git tag
v1.0
v2.0
$ git log
commit aae07ff1e1185c16634cc0949ef03e7f94ca023e (HEAD -> main, tag: v2.0)
Author: Marcelo de Paiva Barbieri <[e-mail]>
Date:   Fri Aug 2 11:09:11 2024 -0300

    Arquivo main.txt

commit f0ccc3bb4d5516d321c8b5768b769dde8bf0b290 (tag: v1.0)
Author: Marcelo de Paiva Barbieri <[e-mail]>
Date:   Fri Aug 2 10:35:12 2024 -0300

    Primeiro Commit

Exibe

$ git show v2.0
tag v2.0
Tagger: Marcelo de Paiva Barbieri <[e-mail]>
Date:   Fri Aug 2 12:22:45 2024 -0300

Versão 2.0

commit aae07ff1e1185c16634cc0949ef03e7f94ca023e (HEAD -> main, tag: v2.0)
Author: Marcelo de Paiva Barbieri <[e-mail]>
Date:   Fri Aug 2 11:09:11 2024 -0300

    Arquivo main.txt

diff --git a/main.txt b/main.txt
new file mode 100644
index 0000000..6997b4e
--- /dev/null
+++ b/main.txt
@@ -0,0 +1 @@
+arquivo main.txt

Exclui

$ git tag -d v2.0
Deleted tag 'v2.0' (was 05a241e)
$ git tag
v1.0
$ git log
commit aae07ff1e1185c16634cc0949ef03e7f94ca023e (HEAD -> main)
Author: Marcelo de Paiva Barbieri <[e-mail]>
Date:   Fri Aug 2 11:09:11 2024 -0300

    Arquivo main.txt

commit f0ccc3bb4d5516d321c8b5768b769dde8bf0b290 (tag: v1.0)
Author: Marcelo de Paiva Barbieri <[e-mail]>
Date:   Fri Aug 2 10:35:12 2024 -0300

    Primeiro Commit