2.6 Fundamentos de Git - Criando Tags

Listar tags disponíveis no Git não tem rodeios. Apenas escreva git tag:

Esse comando lista as tags em ordem alfabética; a ordem na qual eles aparecerem não tem real importância.

Você pode também procurar por tags com algum padrão em especifico. O repositório fonte do Git, por exemplo, contém mais de 500 tags. Se você deseja procurar apenas a série 1.8.5, você pode executar isso:

O Git usa dois tipos de tags: Leve e Anotada.

Uma tag do tipo leve é muito parecida com um branch que não muda – Ela apenas aponta para um commit em especifico.

Tags anotadas, entretanto, são um armazenamento completo de objetos no banco de dados do Git. Elas têm checksum, contem marcações de nome, email e data; têm uma mensagem de tag; e podem ser assinadas e asseguradas pela GPG (GNU Privacy Guard). É geralmente recomendado que você crie tags anotadas assim você tem todas as informações; mas se você quer um tag temporária ou por alguma razão não quer manter todas as informações, tags do tipo leve esta disponíveis para isso.

Criar uma tag anotada no Git é simples. A forma mais fácil é por especificar o parâmetro -a quando você executa o comando tag:

O -m define a mensagem de tag, a qual é armazenada junto com a tag. Se você não especificar uma mensagem para uma tag anotada, o Git abre seu editor para que você possa digitar nele.

Você pode ver os dados da tag juntamente com o commit onde ela foi realizada usando o comando git show:

Este mostra as informações de tag, a data do commit atrelado a tag, e a mensagem antes mesmo de mostrar as informações do commit.

Uma outra forma de submeter uma tag é usando o tipo leve. Isso é basicamente o checksum de commit armazenando em um arquivo – nenhuma outra informação é mantida. Para criar uma tag do tipo leve, não forneça as opções -a, -s, or -m:

Dessa vez, se você executar git show nessa tag, você não verá as informações extras. O comando apenas mostrará o commit:

Você pode também criar uma tag após já ter realizado o commit. Suponha que seu histórico de commits seja semelhante a este:

Agora, suponha que você esqueceu de criar a tag na versão v1.2, a qual equivale ao commit “updated rakefile”. Você pode adicionar isso posteriormente. Para criar uma tag neste commit, você deve informar o checksum do commit (ou parte dele) ao final do comando:

Você pode ver que criou uma tag para o commit:

Por padrão, o comando git push não envia as tags para os servidores remoto. Você terá que explicitamente enviar as tags para o servidor de compartilhamento depois de tê-las criado. Esse processo é semelhante a compartilhar branches remotos – você pode executar git push origin [tagname].

Se você tem muitas tags que você quer enviar de uma vez, você pode também usar a opção --tags atrelada ao comando git push. Isso vai transferir todas as suas tags ainda não enviadas para o servidor remoto.

Agora, quando alguém executar um clone ou pull a partir do seu repositório, ele vai puxar também todas as tags. ==== Checando as Tags

Você não pode realizar o checkout de uma tag no Git, uma vez que elas não podem ser movidas. Se você quer deixar uma versão do seu repositório idêntica a uma tag especifica em seu diretório de trabalho, você pode criar um novo branch em uma tag especifica com o comando git checkout -b [branchname] [tagname]:

Claro que se você fazer isso e realizar um commit, seu branch version2 será ligeiramente diferente do que a tag v2.0.0 assim você irá seguir em frente com suas novas modificações, então seja cuidadoso.