Lab Niveau 15 — Tags & Conventions de Release

Progression dans cet atelier 0%

Objectifs

Créer un tag léger pour identifier temporairement un commit.
Créer un tag annoté pour marquer une version stable majeure.
Pousser un tag individuel et l’ensemble des tags locaux sur un dépôt distant.
Rédiger des notes de release professionnelles selon le standard Keep a Changelog.

Exercice Pratique

Dans cet exercice, vous allez simuler la publication de la première version stable d’un micro-service en marquant le bon commit avec un tag annoté, puis en le publiant de manière professionnelle.

Étape 1 : Préparation de l’historique

Dans votre dépôt local de TP :

Assurez-vous d’être sur la branche principale (main) et réalisez un commit en ajoutant un fichier app.js contenant un simple script d’affichage.
Créez un commit correctif rapide en modifiant le fichier app.js (par exemple, pour corriger un message de console ou une variable).

Étape 2 : Création des Tags

Créer un tag léger sur votre avant-dernier commit (le commit initial de configuration) pour l’étiqueter comme prototype :
Terminal window
```
# Récupérez l'identifiant (SHA-1) du commit cible via git log, puis :
git tag prototype <SHA-1-du-commit>
```
Créer un tag annoté sur votre dernier commit (la version stable corrigée) afin de déclarer la livraison officielle de la version v1.0.0 :
Terminal window
```
git tag -a v1.0.0 -m "Release v1.0.0 - Version stable initiale de notre micro-service"
```
Affichez la liste des tags pour vérifier leur présence :
Terminal window
```
git tag
```
Examinez le contenu et les métadonnées (auteur, date, message) de votre tag annoté :
Terminal window
```
git show v1.0.0
```

Étape 3 : Push vers le dépôt distant

Par défaut, un simple git push n’envoie pas vos tags locaux sur GitHub.

Poussez votre tag de version stable vers le serveur distant origin :
Terminal window
```
git push origin v1.0.0
```
Poussez l’ensemble de tous les tags créés (y compris le tag léger prototype) d’un seul coup :
Terminal window
```
git push origin --tags
```

Étape 4 : Rédiger le Changelog

Écrivez un changelog de publication fictif pour cette version v1.0.0 en classant les changements selon les catégories standards (Added et Fixed).

Checklist de validation

La commande git tag affiche à la fois prototype et v1.0.0.
La commande git show v1.0.0 affiche les informations de l’auteur, la date et le message d’annotation.
Les tags ont été poussés sur le dépôt distant avec succès.
Le message de release respecte les sections réglementaires (Added et Fixed).

Compétences acquises

Identification et gel des versions de code dans l’historique Git
Utilisation des tags locaux et distants (légers et annotés)
Formalisation et catégorisation des livraisons logicielles (SemVer & Changelogs)

Fiches de révision

Question

Quelle commande Git liste tous les tags présents sur le dépôt local ?

Cliquer pour révéler la réponse

Réponse

git tag

Cliquer pour voir la question

Question

Quelle est la commande pour pousser tous les tags locaux d'un coup sur GitHub ?

Cliquer pour révéler la réponse

Réponse

git push origin --tags

Cliquer pour voir la question

Question

Quelle commande permet de supprimer un tag distant sur GitHub ?

Cliquer pour révéler la réponse

Réponse

git push origin --delete <nom-du-tag>

Cliquer pour voir la question

Évaluation des connaissances

Quelle commande Git crée un tag annoté nommé v1.0.0 ?

Pourquoi les tags annotés sont-ils préférés aux tags légers pour les releases ?

Quelle commande permet d'inspecter les détails et le commit associé d'un tag ?