Skip to content
Développement PrestaShop

Vérifier les hooks et les points de rupture lors d’une migration vers la branche 9

13 mai 2026
Alexandre
7 min. de lecture
Vérifier les hooks et les points de rupture lors d’une migration vers la branche 9

Lors d’une migration vers une « branche 9 » (qu’il s’agisse d’une branche de refonte, d’un socle technique ou d’une version majeure de votre projet PrestaShop), les régressions ne viennent pas toujours du code applicatif. Très souvent, ce sont les garde-fous Git, hooks et règles de validation, qui créent les blocages les plus coûteux, notamment quand un push devient soudainement impossible.

Dans un contexte d’équipe (agence, marchand, développeurs internes), sécuriser la migration signifie donc aussi vérifier les points de rupture dans la chaîne Git : hooks serveur (pré-réception), hooks locaux, politiques de branche, performances et droits. L’objectif : éviter qu’un contrôle mal calibré ne « verrouille » votre dépôt au moment où vous devez livrer vite et proprement.

1) Cartographier les hooks impliqués dans votre flux vers la branche 9

Avant toute action, établissez une cartographie des contrôles qui s’exécutent pendant un push vers votre dépôt : hooks côté serveur (notamment pre-receive sur GitHub Enterprise Server), règles de protection, checks CI, et hooks côté poste (pre-commit, commit-msg, etc.). Cette vision d’ensemble est essentielle, car un échec peut provenir d’un endroit inattendu, surtout si la branche 9 change vos conventions (noms de branches, version PHP, linters, structure des dossiers, etc.).

Sur GitHub Enterprise Server (GHES), les pre-receive hooks sont exécutés à chaque push, dans un environnement isolé. Point crucial : un code de sortie non nul rejette l’envoi. En pratique, cela signifie que même si votre code compile localement et que votre CI est verte, un hook serveur peut empêcher totalement l’arrivée des commits sur la branche 9.

Dans une migration PrestaShop, ces hooks sont souvent utilisés pour imposer des règles de qualité (formatage, conventions de commit), des règles métier (interdiction de pousser sur certaines branches), ou des exigences de conformité (détection de secrets, restrictions sur des fichiers sensibles). Votre cartographie doit donc inclure les règles « officielles » et les exceptions historiques (scripts ajoutés au fil du temps, forks, dépôts miroirs) qui risquent de se comporter différemment avec la branche 9.

2) Comprendre le point de rupture majeur : un hook peut bloquer tous les pushes

GitHub documente explicitement qu’un hook peut « lock a branch or repository by rejecting all pushes ». Autrement dit : un simple changement de logique dans un script, une dépendance manquante, ou une condition trop stricte peut transformer la migration vers la branche 9 en panne globale, où plus personne ne peut livrer.

Il est important de rappeler le moment exact d’exécution : le hook de pré-réception est invoqué par git-receive-pack après le push et avant l’actualisation des références (refs) sur le dépôt distant. Concrètement, vos commits « arrivent » côté serveur, puis le hook décide si les refs (la branche 9, un tag, etc.) peuvent être mises à jour. C’est ce mécanisme qui rend le rejet si immédiat et si bloquant.

Heureusement, le diagnostic est généralement assez visible côté client : en cas de rejet, Git affiche un message explicite de type pre-receive hook declined. Pendant la migration, incitez l’équipe à copier-coller ces messages dans vos tickets (ou votre canal de support interne) : cela accélère considérablement l’identification du contrôle fautif et évite les débats « c’est la CI » vs « c’est Git ».

3) Tester en mode “testing” pour sécuriser la transition vers la branche 9

Les versions récentes de GHES documentent trois états d’exécution des pre-receive hooks : enabled, disabled, testing. Dans une migration vers la branche 9, le mode testing est le principal filet de sécurité : il exécute le script sans rejeter les pushes. Vous obtenez ainsi les résultats du contrôle (logs, métriques, erreurs) sans casser le flux de livraison.

En pratique, utilisez testing pour valider vos hypothèses : le hook comprend-il les nouveaux chemins de fichiers ? Est-il compatible avec la nouvelle stratégie de branches ? Détecte-t-il à tort des « secrets » parce que des fixtures ont changé ? Cette approche est particulièrement utile quand la branche 9 introduit des évolutions structurelles (monorepo, nouveaux outils front, migration PHPUnit, ajout de packages, etc.).

Organisez cette phase comme un véritable plan de recette : (1) liste des règles que le hook est censé appliquer, (2) cas passants/ cas bloquants attendus, (3) comparaison des résultats entre la branche actuelle et la branche 9. Une fois la preuve faite, vous pourrez basculer en enabled avec un risque bien plus faible de blocage total.

4) Surveiller timeouts et performances : le piège invisible des hooks

La documentation recommande d’éviter les opérations Git longues dans un hook, car cela impacte les workflows et peut déclencher des échecs de traitement. Lors d’une migration vers la branche 9, ce risque augmente : dépôts plus volumineux, historiques plus lourds, nouveaux binaires, nouveaux dossiers générés, etc. Un hook peut devenir « lent » sans que sa logique ait changé, simplement parce que le contexte a évolué.

Testez explicitement les timeouts et la performance. Mesurez des pushes représentatifs : petite correction (1 commit), refonte (plusieurs dizaines de fichiers), ajout de dépendances, ajout de médias (idéalement à éviter, mais parfois réel). Surveillez également les scénarios concurrents : si plusieurs développeurs poussent en même temps, un hook coûteux peut devenir un goulot d’étranglement.

Si vous identifiez une lenteur, privilégiez des stratégies pragmatiques : déplacer certains contrôles lourds en CI (où c’est plus adapté), optimiser les commandes Git utilisées, ou réduire le périmètre d’analyse (par exemple uniquement les fichiers modifiés). L’objectif n’est pas d’abandonner la qualité, mais de garder un pipeline viable pour l’équipe pendant et après la migration.

5) Vérifier les contraintes de branche par défaut et les droits d’administration GHES

Un point de rupture fonctionnel souvent sous-estimé : certains hooks ne peuvent être ajoutés que depuis la branche par défaut. Si votre migration vers la branche 9 s’appuie sur une branche non par défaut (par exemple une branche de transition, un long-lived branch, ou un dépôt miroir), vérifiez ce prérequis très tôt. Sinon, vous risquez de découvrir trop tard que votre chaîne de déploiement ne peut pas activer (ou modifier) le contrôle au bon endroit.

Autre contrainte : les APIs de hooks de pré-réception sont réservées aux administrateurs de site GHES. En phase de migration, cela a des implications concrètes : besoin d’un créneau avec l’admin, validation d’un plan de changement, documentation de rollback, et parfois passage par un processus interne de conformité. Intégrez ces délais dans votre planning, surtout si la branche 9 est liée à une deadline métier (mise en ligne, soldes, campagne marketing).

Enfin, attention à la compatibilité temporelle des documentations et versions. Certaines docs GHES sont déjà marquées obsolètes ou discontinuées (par exemple GHES 3.15 est indiqué comme discontinué depuis le 23/04/2026). Pour une migration « à jour », basez-vous sur la documentation correspondant à votre version cible, et évitez de caler votre stratégie sur des comportements issus de versions en fin de vie.

6) Harmoniser les hooks locaux pour accélérer la migration (Lefthook, Overcommit, GitHub Desktop)

La migration vers la branche 9 est souvent l’occasion de rationaliser les contrôles côté développeur, afin de réduire les erreurs avant même le push. Des gestionnaires de hooks Git comme Lefthook (maintenu, multi-langage, exécution parallèle) peuvent standardiser l’exécution de lint, tests rapides, validation de messages de commit, etc. Cela évite de « découvrir » au moment du push que le serveur refuse votre travail.

Overcommit est une autre option côté projet, utile quand vous souhaitez une configuration plus structurée (notamment dans certains stacks Ruby, mais pas exclusivement) et une gouvernance claire des hooks partagés. Dans un contexte PrestaShop, l’idée reste la même : rendre les contrôles reproductibles sur les postes, et limiter la variabilité entre développeurs, agences externes, et environnements CI.

Pour les équipes mixtes (profils moins techniques, ou contributeurs ponctuels), n’oubliez pas que GitHub Desktop supporte l’exécution et le contournement de hooks Git côté poste de travail. C’est pratique pour tester l’impact d’une migration sur les validations locales, tout en gardant une porte de sortie temporaire (par exemple pour isoler un problème). Attention : contourner un hook local ne contourne pas un pre-receive hook serveur ; d’où l’importance de coordonner les deux niveaux.

Vérifier les hooks et les points de rupture lors d’une migration vers la branche 9 revient à sécuriser votre capacité à livrer. Les pre-receive hooks GHES, exécutés à chaque push, peuvent améliorer fortement la qualité… ou, en cas de mauvaise configuration, verrouiller complètement une branche ou un dépôt en rejetant tous les pushes.

La démarche la plus robuste consiste à cartographier les contrôles, tester en mode testing comme filet de sécurité, valider performances et timeouts, puis traiter les contraintes de gouvernance (branche par défaut, droits admin, versions GHES). En complément, l’harmonisation des hooks locaux avec des outils comme Lefthook ou Overcommit réduit les frictions et aide toute la communauté (marchands, agences, développeurs) à réussir la migration vers la branche 9 sans interruption.

Partager cet article