Accueil › Git & CI/CD › Les hooks Git
Les hooks Git
Hooks et qualité automatiqueavance
Un hook est un script exécutable que Git lance à un moment précis. Git ne regarde qu'une chose : son code de sortie. Zéro, l'opération continue. Non nul, elle est annulée.
#!/bin/sh
# .git/hooks/pre-commit
if git diff --cached --name-only | grep -q '\.env$'; then
echo "Refus : un fichier .env est dans l'index."
exit 1
fi
Rendez-le exécutable, sinon Git l'ignore en silence :
chmod +x .git/hooks/pre-commit
Deux familles
| S'exécute sur | Contournable | Rôle | |
|---|---|---|---|
| Client | votre machine | oui, --no-verify |
retour rapide, confort |
| Serveur | le dépôt distant | non | règle réellement imposée |
Le problème qui définit tout le reste
.git/hooks est à l'intérieur de .git. Ce répertoire n'est pas versionné
et n'est pas cloné. Un hook que vous y posez n'existe que chez vous.
git config core.hooksPath .githooks
Cette option déplace le répertoire des hooks vers un dossier ordinaire, donc versionné, donc partagé. C'est le mécanisme sur lequel reposent tous les outils de gestion de hooks. Il reste une étape manuelle : quelqu'un doit exécuter cette commande après le clone.
Ce qu'un hook client ne fait pas
Il n'empêche rien. git commit --no-verify existe et c'est volontaire :
personne ne doit être empêché de sauvegarder son travail par un outil de
qualité. Un hook client est un conseil rapide, pas une barrière.
Les termes à connaître
- Hook
Un script exécutable que Git lance à un moment précis de son fonctionnement. Si le script sort avec un code non nul, Git interrompt l'opération — c'est tout le mécanisme.
- .git/hooks
Le répertoire où Git cherche ses hooks. Il est à l'intérieur de
.git, donc jamais versionné et jamais cloné : un hook posé là n'existe que sur votre machine.- core.hooksPath
Option de configuration qui déplace le répertoire des hooks. En la pointant vers un dossier versionné, on rend les hooks partageables — c'est le mécanisme utilisé par tous les outils modernes.
- Hook client
Exécuté sur la machine du développeur :
pre-commit,commit-msg,pre-push. Contournable par--no-verify, donc conseil plutôt que règle.- Hook serveur
Exécuté sur le dépôt distant à la réception d'une poussée :
pre-receive,update,post-receive. Non contournable par le client — c'est la seule barrière réelle.- --no-verify
Drapeau de
git commitetgit pushqui saute les hooks clients concernés. Il existe volontairement : un hook client ne doit jamais empêcher quelqu'un de sauvegarder son travail.- Code de sortie
La seule chose que Git regarde. Zéro : l'opération continue. Non nul : elle est annulée. La sortie standard du hook est affichée à l'utilisateur.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.