Tutoriel sur les balises Git : Comment créer, gérer et utiliser les étiquettes

Comment créer et gérer des balises Git

La création et la gestion des balises Git sont simples. Voyons quels sont les différents types de balises et comment les appliquer.

• Pour utiliser les balises Git, vous devez avoir installé Git sur votre machine. Vous pouvez en savoir plus sur l'installation de Git dans le tutoriel d'installation de Git. 
• Un autre prérequis est d'avoir un dépôt Git initialisé. Vous pouvez en savoir plus en lisant Comment initialiser et configurer un dépôt Git.

Création de balises légères

Une balise légère est comme un pointeur vers un commit. Il n'inclut pas de métadonnées, mais seulement le nom de la balise et le commit vers lequel elle pointe.

Pour en créer un, vous pouvez exécuter la commande suivante 

git tag v1.0.0

Cette commande crée une balise légère pointant vers le commit actuel de HEAD. 

Vous pouvez également créer un tag pour un commit spécifique en fournissant le hash du commit :

git tag v1.0.0 5c5fc06

Les étiquettes légères sont utiles pour les références rapides et locales, en particulier dans les projets de développement en solo ou le travail temporaire.

Création de balises annotées

Les balises annotées contiennent davantage d'informations, telles que le nom, l'adresse électronique, la date et le message de l'auteur de la balise. Ils sont stockés en tant qu'objets Git complets et sont idéaux pour marquer les versions officielles ou les étapes importantes.

Vous pouvez en créer un en cours d'exécution : 

git tag -a v1.0.0 -m "Release version 1.0.0"

Cette commande crée une balise annotée appelée v1.0.0 avec le message "Release version 1.0.0".

Vous pouvez également marquer une livraison spécifique :

git tag -a v1.0.0 5c5fc06 -m "Tagging older commit"

Les balises annotées offrent une meilleure documentation, s'intègrent bien aux outils CI/CD et aident les équipes à suivre l'historique de manière plus transparente.

Marquer des commits spécifiques

Parfois, vous devez marquer un commit qui n'est pas le plus récent. Pour cela, vous pouvez d'abord récupérer l'historique des commits, puis sélectionner le hash du commit pour lequel vous souhaitez créer une balise.

Pour récupérer le hash du commit, vous pouvez exécuter la commande suivante :

git log --oneline

Copiez ensuite le hachage de la validation dans la liste :

git tag -a v1.0.0 <commit-hash> -m "Tagging v1.0.0 release"

Vérification des étiquettes créées

Pour lister tous les tags de votre référentiel, utilisez :

git tag

Si vous voulez filtrer les étiquettes, par exemple, seulement les versions commençant par v1., utilisez :

git tag -l 'v1.*'

Pour afficher les détails d'une balise spécifique, exécutez :

git show v1.0.0

Travailler avec les balises Git

Une fois que vous avez créé des balises Git, vous devrez souvent les partager, les mettre à jour ou interagir avec elles dans le cadre de votre flux de travail de développement ou de publication. Cette section couvre les tâches les plus courantes pour travailler avec des balises dans des référentiels locaux et distants. 

Envoi de balises à un dépôt distant

Les balises ne sont pas automatiquement poussées vers les dépôts distants lorsque vous exécutez git push. Vous devez les pousser explicitement.

Pour pousser une seule balise :

git push origin v1.0.0

Pour pousser toutes les balises en même temps :

git push --tags

Les balises doivent être poussées pour que vos coéquipiersou les pipelines CI/CD puissent ay accéder. Les balises sont souvent utilisées comme déclencheurs de déploiement, en particulier dans le cadre de flux de versions. Vous pouvez en savoir plus sur la façon de pousser et de tirer des branches dans le tutoriel Git Push and Pull.

Suppression de balises

Si vous souhaitez supprimer une balise, vous pouvez le faire localement et à distance.

Pour le supprimer localement, exécutez la procédure suivante :

git tag -d v1.0.0

Pour ensuite supprimer la même balise du référentiel distant :

git push origin --delete v1.0.0

Vous pouvez également supprimer directement la balise depuis GitHub ou l'interface web de GitLab. 

>Si vous souhaitez en savoir plus sur GitHub et son utilisation, je vous recommande les cours GitHub Foundations et GitHub Concepts.es GitHub Foundations et GitHub Concepts.

Vérification des étiquettes

Vous pouvez adapter votre référentiel à l'état d'une balise spécifique en exécutant :

git checkout v1.0.0

Cependant, cela vous place dans un étatdétaché de la tête. Cela signifie que vous n'êtes plus sur une branche, et que les nouveaux commits n'appartiendront à aucune branche à moins que vous n'en créiez une explicitement :

git checkout -b hotfix-v1.0.0

L'extraction d'une balise spécifique permet de déboguer ou d'examiner une version particulière sans affecter votre branche de développement actuelle. Il est également utilisé pour construire votre application de production à partir d'une version spécifique, par exemple, lorsqu'une image Docker doit être construite.

Marquage après un commit

Si vous devez mettre à jour une balise, par exemple en la remplaçant par un autre commit ou en modifiant le message, vous pouvez simplement forcer une mise à jour en lançant la commande :

git tag -f -a v1.0.0 5c5fc06 -m "retagging"

Vous pouvez également exécuter la même opération sans le hash du commit pour ajouter simplement la balise à l'adresse HEAD.

>Si vous avez besoin d'une vue d'ensemble rapide des commandes traditionnelles de Git, je vous recommande l'aide-mémoire complet de Git.

Bonnes pratiques pour l'utilisation des balises Git

Savoir créer et gérer des balises est une chose, mais les utiliser efficacement en est une autre. Utilisées à bon escient, les balises peuvent améliorer votre flux de travail, votre documentation et la communication au sein de votre équipe.

Utilisation de balises pour la gestion des versions

Les balises sont parfaitespour le versionnage sémantique, quiest la méthode recommandée pour le versionnage de vos versions.

En version sémantique, vos numéros de version suivent le format MAJOR.MINOR.PATCH, par exemple, v.1.2.0.

MAJOR sont destinées aux modifications plus importantes et aux ruptures, tandis que les versions MINOR sont destinées aux nouvelles fonctionnalités et PATCH aux corrections de bogues.

Le versionnage sémantique est très puissant. Il communique clairement la portée des changements, aide les développeurs à comprendre la compatibilité et fonctionne bien avec des outils automatisés tels que les déclencheurs CI/CD.

Respectez une convention de dénomination cohérente. Choisissez un modèle (par exemple, préfixez toujours par v) et suivez-le dans toutes vos publications.

Étiquetage des communiqués

Les étiquettes sont idéales pour marquer les étapes clés de votre projet. Voici quelques types d'étiquettes utiles que vous pouvez envisager :

• v1.0.0-alpha: Version de test interne
• v1.0.0-beta: Version bêta publique
• v1.0.0: Mise en production finale

En étiquetant ces étapes, vous pouvez partager plus facilement des versions de test avec d'autres personnes, revenir à des versions antérieures et conserver un historique clair des déploiements en production. 

Vous pouvez encore améliorer le processus en utilisant des balises annotées pour les versions afin de capturer le contexte et la documentation appropriés.

Éviter la surutilisation des balises

Aussi pratiques et puissantes que soient les balises, elles peuvent devenir inutiles lorsqu'elles sont utilisées à l'excès. Les étiquettes ne doivent marquer que des points significatifs dans l'histoire de votre projet, comme les versions stables, les fonctionnalités majeures, les étapes ou les échéances. 

L'étiquetage de chaque livraison encombre votre dépôt et va à l'encontre de l'objectif d'une navigation rapide. Veillez à ce qu'il soit propre et utile !

En règle générale, il n'est probablement pas nécessaire d'apposer une étiquette si vous ne la déployez pas ou si vous ne l'annoncez pas.

Dépannage des balises Git

Même en appliquant les meilleures pratiques, vous rencontrerez parfois des problèmes lors de l'utilisation des balises Git, en particulier lorsque vous travaillez avec des équipes ou que vous vous synchronisez avec des dépôts distants. Cette section explique comment résoudre les problèmes les plus courants.

Gestion de l'état HEAD détaché

Lorsque vous retirez une étiquette spécifique en utilisant :

git checkout v1.0.0

Git vous met dans un état détaché HEAD, comme mentionné précédemment. Cela signifie que vous n'êtes pas sur une branche, donc si vous faites un commit, il n'appartiendra à aucune branche et pourra être perdu si vous n'agissez pas. 

Vous pouvez y remédier en créant une branche en exécutant ce qui suit :

git checkout -b hotfix-v1.0.0

Vous travaillez maintenant sur une branche et vous pouvez livrer et pousser des changements comme d'habitude.

Résoudre les conflits de balises

Des conflits peuvent survenir lorsque le même nom de balise pointe vers des commits différents localement et à distance. 

Cela se produit souvent lorsque vous supprimez et recréez une balise localement, ou lorsque quelqu'un d'autre force une balise.

Il existe deux options pour résoudre ce problème.

Option 1 : Supprimer et réinsérer la balise

git tag -d v1.0.0
git push origin --delete v1.0.0
git tag -a v1.0.0 -m "Corrected tag"
git push origin v1.0.0

Option 2 : Forcer la mise à jour de la balise

Si vous êtes sûr que votre étiquette locale est la bonne et que vous en avez l'autorisation :

git push origin -f v1.0.0

Mais soyez prudent avec cette option, car le passage en force peut écraser les modifications des autres. Ne l'utilisez que lorsque vous êtes sûr de vous ou après avoir communiqué avec votre équipe.

Conclusion

Les balises Git sont un outil puissant lorsqu'elles sont utilisées à bon escient. Dans ce tutoriel, vous avez appris :

• Que sont les balises Git et quand les utiliser ?
• Comment appliquer les balises Git à votre dépôt ?
• Bonnes pratiques pour l'utilisation des balises Git
• Comment résoudre les problèmes les plus courants lorsque vous travaillez avec des balises Git ?

Qu'il s'agisse de publier des modèles d'apprentissage automatique, de diffuser des mises à jour d'un produit de données ou de collaborer au sein d'une équipe, les balises vous aident à marquer des moments importants dans le calendrier de votre projet. Ils permettent d'organiser les choses, de les reproduire et de faciliter le retour en arrière ou le déploiement.

J'utilise constamment les étiquettes Git. Ils me font gagner des heures en me permettant de revenir à des versions stables lorsque des bogues apparaissent ou de déclencher des flux de travail CI/CD automatisés. Je les utilise pour étiqueter et versionner les images Docker pour les constructions de production, en veillant à ce que tout ce que j'expédie soit entièrement traçable et documenté.

Commencez donc à utiliser les balises dès aujourd'hui et transformez votre flux de travail Git !