Outils pour utilisateurs

Outils du site


command-line:git:tags

Tag : étiquetter ses version

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.

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

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 :

git tag v1.3b1

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 :

git tag -a v1.1 -m "J'avais oublié celui-là" 305bdd6
git tag -a v1.1 305bdd6 -m "J'avais oublié celui-là"

Partager les tags

Par défaut, ces tags ne sont pas transmis par push, à moins de le préciser :

git push origin --tags

Les tags “légers” seront aussi transmis.

command-line/git/tags.txt · Dernière modification : le 18/11/2013 à 15:58 de Yosko