Git tag : pour nommer des versions

Anne git

Les numéros de commit, ce n’est quand même pas très parlant. Il vaut mieux nommer les versions si on veut les retrouver par la suite.

Ajouter un tag

Git propose deux sortes de tag :

  • les tags légers qui sont fait pour être utilisés localement :

      $ git tag ici_ca_marche
    
  • et les tags destinés à être poussé dans le dépôt. Il faut alors obligatoirement leur associer un message :

      $ git tag -a mon_tag -m "la description correspondante"
    

Pour pousser un tag :

    $ git push origin mon_tag

Information sur les tag

Pour voir tous les tags avec leur description :

$ git tag -n

On peut filtrer avec une expression régulière sur les tags comme par exemple :

$ git tag -n -l "v1.*"

Pour voir le commit du tag :

$ git log -1 mon_tag

Et pour voir la date (du commit, pas du tag) :

$ git log -1 mon_tag --pretty="%ci"

On peut aussi avoir tous les tags classés par date avec :

for t in $(git tag) ; do echo $(git log -1 --pretty="%ci (%h)" $t) $t ; done | sort

Ou plus proprement, directement avec git :

$ git log --tags --simplify-by-decoration --pretty="format:%ci %d"

Détruire un tag

Pour détruire un tag :

  • localement :

      $ git tag -d mon_tag
    
  • sur le dépôt :

      $ git push --delete origin mon_tag
    

Voir aussi :