Skip to main content

Utilisation des hooks Git dans GitHub Desktop

Vous pouvez exécuter des hooks Git dans votre environnement shell et contourner les hooks de validation directement depuis GitHub Desktop.

À propos des hooks Git dans GitHub Desktop

Les hooks Git sont des scripts qui s’exécutent automatiquement à des points spécifiques dans le flux de travail Git, comme avant ou après une validation, un envoi (push) ou une fusion. Ils peuvent être utilisés pour appliquer des normes de qualité du code, exécuter des tests ou effectuer d’autres tâches automatisées.

GitHub Desktop exécute des hooks Git dans votre environnement shell configuré. Les hooks ont accès aux mêmes variables et outils d’environnement que lorsque vous exécutez Git à partir de la ligne de commande. Cela signifie que les crochets qui s’appuient sur les outils installés via des gestionnaires de versions (par exemple nvm``rbenv) ou qui dépendent des fichiers de configuration de l’interpréteur de commandes (tels que .bash_profile ou .zshrc) fonctionnent correctement.

La sortie des hooks s’affiche en temps réel dans l’interface utilisateur de GitHub Desktop, avec les couleurs et le formatage du terminal préservés, afin que vous puissiez facilement lire et déboguer la sortie de vos hooks.

Ignorer un hook de commit

Si vous souhaitez effectuer une validation sans exécuter vos hooks de pré-validation ou commit-msg, vous pouvez les contourner directement à partir de GitHub Desktop. Cela équivaut à utiliser git commit --no-verify sur la ligne de commande.

Vous pouvez contourner les hooks prématurément avant d’effectuer une validation ou après l’échec d’un hook.

Ignorer les hooks avant de valider

  1. Dans l’onglet « Modifications », écrivez votre message de validation.
  2. À côté du champ de message de validation, cliquez sur .
  3. Sélectionnez Contourner les hooks de validation.
  4. Cliquez sur Commit to BRANCH.

Contournement d’un point d'ancrage défaillant

Si un hook de validation échoue, GitHub Desktop affiche la sortie du hook et vous donne la possibilité de contourner le hook ayant échoué et de poursuivre la validation.

  1. Passez en revue le résultat du hook affiché par GitHub Desktop.
  2. Pour poursuivre la validation malgré l’échec, cliquez sur Valider de toute façon.

Avertissement

Ignorer les hooks de commit contourne les contrôles de qualité et de sécurité sur lesquels votre équipe peut compter. Contournez un crochet uniquement si vous comprenez les implications.

Lectures complémentaires

  •         [AUTOTITLE](/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop)
    
  •         [Documentation sur les hooks Git](https://git-scm.com/docs/githooks) dans la référence Git officielle