Marquer la version livrée avec un tag

Une branche indique l’évolution d’un travail ; elle continue à avancer quand de nouveaux commits sont ajoutés. Pour retrouver précisément ce qui a été livré, vous avez besoin d’un repère stable associé au commit d’intégration de la fonctionnalité « Nouveaux guides ».

Dans cette leçon, vous marquez la version livrée sur `main`, puis vous publiez ce repère sur le dépôt distant. Vous pourrez ainsi identifier le commit exact associé à la livraison, même après l’ajout de nouveaux changements sur la branche.

Choisir le commit à marquer

Le tag doit désigner le commit qui contient la fonctionnalité intégrée et revue, et non un commit encore présent uniquement sur `feature/nouveaux-guides`. Le parcours de revue et d’intégration a déjà établi cet état : la branche principale contient le changement, et la résolution de conflit a été vérifiée avant l’intégration.

Placez-vous sur `main` et vérifiez le dernier commit avant de créer le repère. La commande `git log -1 --oneline` affiche son identifiant court et son message ; contrôlez qu’ils correspondent bien à l’intégration attendue. Comme vu dans la leçon sur l’état du dépôt, vérifiez également que vous n’avez pas de modifications locales non enregistrées.

git switch main
git log -1 --oneline

a1b2c3d Intégrer les nouveaux guides

Créer un tag annoté

Un tag est un nom associé à un commit, pratique pour retrouver un état précis du projet. Un tag annoté contient en plus des métadonnées, notamment un message et l’identité de la personne qui l’a créé. Il convient donc pour signaler une livraison, contrairement à un simple nom posé sur un commit sans message descriptif.

La commande ci-dessous crée le tag annoté `v1.0.0` sur le commit courant. Ce nom est un choix d’exemple pour la première livraison du projet ; adaptez la numérotation à la convention de version de votre équipe. Le message précise le contenu livré, ici la section « Nouveaux guides ».

git tag -a v1.0.0 -m "Livraison des nouveaux guides"

Vérifier et publier le tag

Avant de publier, inspectez le tag avec `git show`. Git affiche ses métadonnées, son message, le commit désigné et les changements associés. Vérifiez que le commit correspond à l’intégration de la fonctionnalité et que le message identifie clairement la livraison.

git show --no-patch --decorate v1.0.0

tag v1.0.0
Tagger: Votre nom <[email protected]>
Date: ...

Livraison des nouveaux guides

commit a1b2c3d... (HEAD -> main, tag: v1.0.0)
...

Créer le tag dans votre dépôt local ne le rend pas visible aux autres personnes. Publiez-le explicitement en nommant le tag dans `git push`. Cette commande envoie le repère `v1.0.0` à `origin` sans publier automatiquement d’autres tags locaux.

git push origin v1.0.0

 * [new tag]         v1.0.0 -> v1.0.0

Vous pouvez ensuite consulter le tag publié dans l’interface du dépôt distant, généralement dans la liste des tags ou des versions. Les membres de l’équipe peuvent aussi récupérer les tags avec `git fetch --tags`, puis utiliser `git show v1.0.0` pour retrouver le commit de livraison. Le tag fournit un point de référence ; il ne remplace ni la revue ni les vérifications effectuées avant l’intégration.

À retenir

• Créez un tag après l’intégration, sur le commit réellement livré.
• Utilisez un tag annoté et un message explicite pour identifier une livraison.
• Vérifiez la cible et les métadonnées avec `git show` avant publication.
• Publiez le tag explicitement avec `git push origin nom-du-tag`.