Forstå Git-hooks

Velkommen til Git Hooks! Git Hooks er kraftfulde scripts, som kan tilpasses, og som Git udfører automatisk før eller efter hændelser som commit, push eller modtagelse af pushede commits.

Tænk på dem som automatiserede kontrolpunkter eller handlinger i dit Git-workflow. De hjælper med at håndhæve projektstandarder, automatisere opgaver og integrere med andre systemer.

Alle Git-lagre indeholder en mappe med navnet .git/hooks. Her finder du eksempler på hookscripts (som regel med endelsen .sample).

Hvis du vil aktivere et hook, skal du blot fjerne endelsen .sample og gøre filen eksekverbar. Git kører det derefter på det relevante tidspunkt.

• Placering: .git/hooks/
• Filer: Shell-scripts (Bash, Python, Ruby osv.)
• Aktivering: Omdøb og gør eksekverbar

Git Hooks inddeles i to hovedtyper baseret på, hvor de kører:

• Klient-side-hooks: Kører på din lokale maskine (for eksempel før du laver en commit eller rebase). De bruges til automatisering af din personlige arbejdsgang og håndhævelse af lokale regler.
• Server-side-hooks: Kører på den eksterne Git-server (for eksempel når du pusher kode til et delt lager). De håndhæver projektdækkende regler for alle.

Hooket pre-commit er et af de mest almindelige klient-side-hooks. Det kører *før* Git officielt opretter en commit.

Hvis scriptet pre-commit afsluttes med en status, der ikke er nul, afbryder Git committen. Det er perfekt til opgaver som:

• Linting af kode (kontrol for stilfejl)
• Kørsel af enhedstests
• Kontrol for store filer eller følsomme data

Hooket commit-msg kører *efter* at du har indtastet din commitbesked, men *før* committen færdiggøres.

Dette hook er nyttigt til at sikre, at dine commitbeskeder følger bestemte konventioner eller formater. Det kan for eksempel kontrollere, om:

• Beskeden begynder med et sags-id (for eksempel [JIRA-123])
• Beskedens længde er inden for grænserne
• Bestemte nøgleord findes eller ikke findes

Hooket post-commit kører *umiddelbart efter* at en commit er blevet oprettet.

I modsætning til pre-commit eller commit-msg kan dette hook ikke ændre resultatet af committen. Det bruges ofte til notifikationer eller integrationer, for eksempel:

• At underrette teammedlemmer
• At opdatere et projektstyringsværktøj
• At udløse et continuous integration-build (CI-build) (selvom dette er mere almindeligt med server-side-hooks)

På serversiden udføres pre-receive *før* nogen referencer (såsom grene eller tags) opdateres i fjernlageret.

Denne hook er nyttig til at håndhæve vigtige politikker for lageret, f.eks.:

• Forhindre direkte push til grenen main
• Sikre, at alle commits er signerede
• Validere committerens identitet

Hvis denne hook afsluttes med en status, der ikke er nul, afvises hele push-handlingen.

Hooken post-receive køres *efter*, at et push har opdateret referencerne i fjernlageret.

Ligesom post-commit kan denne hook ikke afvise push-handlingen. Den bruges ofte til:

• Udløse CI/CD-pipelines
• Opdatere eksterne systemer til problemsporing
• Sende e-mailnotifikationer til teamet
• Udrulle kode til et testmiljø

For at oprette en hook skal du blot oprette en fil med hookens navn (f.eks. pre-commit) i mappen .git/hooks/. Lad os lave en helt enkel:

Når du har oprettet dit hook-script, skal du gøre det eksekverbart. Ellers kører Git det ikke. Brug kommandoen chmod i din terminal:

chmod +x .git/hooks/pre-commit

Nu kører Git dette script, hver gang du forsøger at lave et commit!

Du har taget det første skridt ind i den effektive verden af Git-hooks!

• Git-hooks er scripts, der automatiserer handlinger under Git-hændelser.
• De ligger i mappen .git/hooks/ i dit lager.
• Hooks er enten på klientsiden (den lokale maskine) eller på serversiden (fjernlageret).
• Vigtige hooks som pre-commit og pre-receive kan håndhæve politikker ved at blokere handlinger.
• Hooks som post-commit og post-receive bruges til notifikationer eller integrationer efter en handling.

Nu dykker vi ned i praktiske eksempler på bestemte hooks!