Les hooks Git et comment automatiser son workflow

Principe de base

Git via les « hooks » propose un moyen d’exécuter des actions personnalisées suite à des événements. Il existe différents hooks, chacun lancés à des moments différents, on peut noter par exemple les suivants :

• pre-commit : lancé avant de lancer un commit, il peut servir par exemple de scanner son code afin de vérifier que l'on a pas oublié d'appels à des fonctions de debug (console.log en js, var_dump en php…)
• pre-push : lancé cette fois avant un git push, je m'en sert comme rempart quand je pousse sur la branche master, afin de demander une confirmation avant de pousser effectivement les modifications.
• Post-receive : lancé après avoir reçu des modifications, c'est à mon sens le plus utile. Il permet d'effectuer des opérations de maintenance (vidage de cache, update de base de données…) mais aussi et surtout on peut s'en servir afin de déployer du code depuis le dépôt git vers le serveur.

Il existe des hooks côté client, comme les deux premiers (pre-commit et pre-push) et des hooks côté serveur, comme le dernier (post-receive)

Les Hooks sont situés dans le dossier caché .git de votre copie de dépôt au sein du dossier hooks :

Ici ce sont des fichiers d'exemple, d'où le prefix .sample, afin d'utiliser un hook vous pouvez renommer celui qui vous intéresse en supprimant le .sample.

Ensuite, c'est simplement un fichier executé, donc il peut être en n'importe quel langage : ruby, bash… tant que l'entête du fichier est présent.

Exemple hook pre-commit : https://github.com/niden/Git-Pre-Commit-Hook-for-certain-words/blob/master/pre-commit

Les hooks avec gitlab

Les hooks peuvent aussi être directement sur votre serveur git, dans le cas du hook post-receive par exemple.

Attention, avec gitlab vos hooks personnalisés devront se situer dans le dossier custom_hooks, ne modifiez surtout pas ceux qui sont dans le dossier hooks car ils sont utilisés par gitlab directement. Il se peut que le dossier custom_hooks n'existe pas, dans ce cas la vous devrez le créer.

Attention encore, pensez bien à définir le propriétaire du dossier et du/des fichiers comme étant votre utilisateur (au sens unix du terme) utilisé par gitlab (par défaut : git)

Le mieux est encore d’exécuter les commande avec sudo en se "faisant passer pour lui" :

sudo -u git -H mkdir custom_hooks

sudo -u git -H vim post-receive

N'oubliez pas que les fichiers doivent être exécutables :

chmod +x post-receive

Pour en savoir plus sur les hooks je vous recommande la page dédié sur la documentation  : https://git-scm.com/book/en/v2/Customizing-Git-Git-Hooks.

À noter, je prépare un article présentant plus en détails le hook post-receive et comment je m'en sers pour déployer en prod et en préproduction suivant la branche courante, à venir dans les jours qui suivent.