Aller au contenu principal

Git avancé : tags, hooks et plus

Va au-delà des bases. Maîtrise les tags, hooks, worktrees, submodules, patches et la configuration pour exploiter toute la puissance de Git.

GitQuest
Démo

Par Anaïs Sparesotto, développeuse web et responsable pédagogique · Mis à jour le

Guide pour utilisateurs avancés

Tu connais les commandes du quotidien. Il est maintenant temps d'explorer les fonctionnalités qui te donnent un contrôle précis sur les releases, l'automatisation, la collaboration et la structure de tes projets.

Tags et releases

Un tag est une référence nommée vers un commit spécifique. Alors que les branches avancent au fur et à mesure que tu ajoutes des commits, les tags restent fixes. C'est la méthode standard pour marquer les points de release dans l'historique de ton projet.

git tag — Marquer les commits importants

Git prend en charge deux types de tags. Un tag léger est simplement un pointeur vers un commit, considère-le comme une branche qui ne bouge jamais. Un tag annoté (git tag -a) est un objet Git complet avec le nom du tagueur, son email, la date et un message. Les tags annotés sont recommandés pour les releases car ils contiennent des métadonnées et peuvent être signés cryptographiquement.

Les tags ne sont pas poussés par défaut : tu dois utiliser git push origin --tags pour les partager avec le dépôt distant. Pour supprimer un tag distant, utilise git push origin :refs/tags/v1.0.0.

Versionnage sémantique

La plupart des projets open-source suivent le Versionnage Semantique (SemVer) pour leurs tags : vMAJEUR.MINEUR.PATCH. Incrémente MAJEUR pour les changements incompatibles, MINEUR pour les nouvelles fonctionnalités rétrocompatibles, et PATCH pour les corrections de bugs. Par exemple, passer de v1.2.3 à v1.3.0 signale une nouvelle fonctionnalité sans changement incompatible.

Référence rapide : v1.0.0 = première release stable. v0.x.y = tout peut changer. Préfixe le tag avec v par convention (par ex., v2.1.0).

Configuration Git

Le comportement de Git est contrôlé par des fichiers de configuration à trois niveaux. Comprendre comment ils se superposent est la clé d'un workflow confortable et personnalisé.

git config — Paramètres locaux, globaux et système

Git lit la configuration depuis trois portées, chacune écrasant la précédente : système (/etc/gitconfig, s'applique à tous les utilisateurs), global (~/.gitconfig, tes paramètres utilisateur), et local (.git/config, par dépôt). Utilise --global pour ton identité et tes préférences, et aucun drapeau (ou --local) lorsqu'un seul projet nécessite des paramètres différents.

Alias utiles

Les alias te permettent de créer des raccourcis pour les commandes que tu tapes souvent. Ils sont stockés dans ton fichier ~/.gitconfig et peuvent te faire gagner un temps considérable au cours de la journée. Voici quelques alias populaires pour démarrer.

Astuce : Tu peux également définir des alias qui exécutent des commandes shell en les prefixant avec !. Par exemple : git config --global alias.undo '!git reset --soft HEAD~1'.

Partager des patches

Avant l'existence des pull requests GitHub, les développeurs partageaient leurs modifications via des fichiers patch envoyés par email. Ce workflow est encore largement utilisé dans des projets comme le noyau Linux, et il reste une compétence utile lorsque tu dois partager des modifications en dehors d'une plateforme hébergée.

git format-patch — Créer des fichiers patch

git format-patch transforme des commits en fichiers .patch contenant le diff ainsi que le message de commit, l'auteur et la date. Chaque commit devient son propre fichier numéroté, prêt à être envoyé par email ou partagé dans un ticket.

git apply — Appliquer des fichiers patch

git apply prend un fichier patch et applique les modifications à ton arbre de travail sans créer de commit. Si tu souhaites conserver les métadonnées du commit original (auteur, message), utilise git am à la place, qui applique le patch et crée un commit en une seule étape.

Travailler avec plusieurs copies

Parfois, tu dois travailler sur deux branches en même temps, par exemple, appliquer un correctif urgent pendant qu'une fonctionnalité est en cours de développement. Au lieu de stasher et changer de branche, Git te permet de maintenir plusieurs répertoires de travail à partir d'un seul dépôt.

git worktree — Plusieurs répertoires de travail

git worktree add crée un nouveau répertoire de travail lié au même dépôt. Chaque worktree extrait une branche différente, et tous partagent les mêmes données .git. Cela signifie pas de clone supplémentaire, pas d'espace disque en plus pour l'historique, et aucun risque de perdre du travail non commité lors d'un changement de contexte.

Empaqueter ton code

Besoin d'envoyer un instantané de ton projet à quelqu'un qui n'utilise pas Git, ou de produire un artefact de release pour le déploiement ? git archive est fait pour cela.

git archive — Exporter une archive propre

git archive exporte le contenu d'un arbre (un commit, une branche ou un tag) sous forme de fichier .zip ou .tar.gz. Contrairement à un simple zip du dossier, git archive exclut le répertoire .git et respecte les règles .gitattributes export-ignore. C'est la manière la plus propre de produire un instantané distribuable.

Git hooks

Les hooks sont des scripts que Git exécute automatiquement à des moments clés de ton workflow. Ils te permettent d'imposer des standards de code, d'exécuter des tests, de valider les messages de commit, ou d'empêcher les push vers des branches protégées, le tout sans dépendre de la discipline humaine.

Les hooks les plus couramment utilisés sont :

  • pre-commit : s'exécute avant la création d'un commit. Utilise-le pour linter le code, exécuter des formateurs, ou vérifier la présence de secrets.
  • commit-msg : s'exécute après la rédaction du message. Utilise-le pour imposer un format comme Conventional Commits.
  • pre-push : s'exécute avant le push. Utilise-le pour lancer la suite de tests et bloquer les push si les tests échouent.

Partage en équipe : Les hooks dans .git/hooks/ ne sont pas versionnés. Pour les partager, place tes scripts dans un dossier suivi (par ex. .githooks/) et exécute git config core.hooksPath .githooks. Des outils comme Husky ou pre-commit automatisent cela pour toi.

Git submodules

Un submodule intègre un dépôt Git à l'intérieur d'un autre. Le dépôt parent enregistre quel commit du submodule extraire, ce qui te permet d'épingler des versions exactes de bibliothèques ou composants partagés. C'est la réponse native de Git aux "dépôts à l'intérieur de dépôts".

Les submodules sont puissants mais ont une courbe d'apprentissage. Lorsque tu clones un projet qui contient des submodules, n'oublie pas de les initialiser et de les mettre à jour. Lorsque tu mets à jour un submodule, tu commites la nouvelle référence dans le dépôt parent.

Alternatives : Si les submodules te semblent trop complexes, envisage git subtree (fusionne le code externe directement dans ton arbre) ou un gestionnaire de paquets spécifique au langage pour les dépendances tierces.

Avec les tags, hooks, worktrees, patches, archives et submodules dans ta boîte à outils, tu es équipé·e pour pratiquement n'importe quel workflow Git. La meilleure façon d'intérioriser ces commandes est de les pratiquer dans un vrai projet, commence petit et progresse.

A

GitQuest est conçu par Anaïs (nouvelle fenêtre), développeuse web et responsable pédagogique, spécialisée en formations tech et accessibilité numérique.

FAQ Git avancé

Prêt à passer au niveau supérieur avec Git ?

Ce guide a couvert la boîte à outils avancée. GitQuest te permet de pratiquer chaque commande dans des scénarios réalistes.