====== Tag : étiquetter ses version ======

[[command-line:git|Retour à l'article Git]]

Les tags sont des étiquettes ajoutées au dépôt qui servent juste à désigner une étape importante dans le développement, comme par exemple un numéro de version.

<code bash>
git tag                             #lists existing tags
git tag -a <tag name> -m <message>  #adds a tag
git tag -a v1.2 -m "My favorite version"
git show v1.2                       #shows information about this tag
</code>
Comme on le voit, ces tags ("annotated tags") sont en quelque sorte des commits qui n'apporteraient aucun changement au code.

Par opposition, il existe aussi des tags "léger" ("lightweight"), en quelque sorte temporaires. Pour cela, on n'ajoute pas d'option à la commande, sauf le nom du tag :
<code bash>
git tag v1.3b1
</code>
Ces tags seront listé avec les autres, mais si on fait un show dessus, on retirera moins d'informations.

Si on souhaite ajouter les tags après coup, alors qu'on a fait des commits depuis, on peut préciser après quel commit insérer le tag en ajouter le début de son checksum dans la commande :
<code bash>
git tag -a v1.1 -m "J'avais oublié celui-là" 305bdd6
git tag -a v1.1 305bdd6 -m "J'avais oublié celui-là"
</code>

===== Partager les tags =====
Par défaut, ces tags ne sont pas transmis par push, à moins de le préciser :
<code bash>
git push origin --tags
</code>
Les tags "légers" seront aussi transmis.