Git Hooks begrijpen

Welkom bij Git Hooks! Git Hooks zijn krachtige, aanpasbare scripts die Git automatisch uitvoert vóór of na gebeurtenissen zoals committen, pushen of het ontvangen van gepushte commits.

Zie ze als geautomatiseerde controlepunten of acties in je Git-werkstroom. Ze helpen projectstandaarden af te dwingen, taken te automatiseren en met andere systemen te integreren.

Elke Git-repository bevat een map .git/hooks. Daarin vind je voorbeeldscripts voor hooks (meestal eindigend op .sample).

Om een hook te activeren, verwijder je eenvoudig de extensie .sample en maak je het bestand uitvoerbaar. Git voert de hook dan op het juiste moment uit.

• Locatie: .git/hooks/
• Bestanden: Shellscripts (Bash, Python, Ruby enzovoort)
• Activering: Hernoemen en uitvoerbaar maken

Git Hooks worden ingedeeld in twee hoofdtypen, afhankelijk van waar ze worden uitgevoerd:

• Client-side hooks: Worden uitgevoerd op je lokale machine (bijvoorbeeld voordat je commit of een rebase uitvoert). Ze zijn bedoeld voor automatisering van je persoonlijke werkstroom en het afdwingen van lokaal beleid.
• Server-side hooks: Worden uitgevoerd op de remote Git-server (bijvoorbeeld wanneer je code naar een gedeelde repository pusht). Ze dwingen projectbrede beleidsregels af voor iedereen.

De hook pre-commit is een van de meestgebruikte client-side hooks. Deze wordt uitgevoerd *voordat* Git officieel een commit maakt.

Als het script pre-commit wordt afgesloten met een status die niet nul is, breekt Git de commit af. Dat is ideaal voor taken zoals:

• Code linten (controleren op stijlfouten)
• Unittests uitvoeren
• Controleren op grote bestanden of gevoelige gegevens

De hook commit-msg wordt uitgevoerd *nadat* je het commitbericht hebt ingevoerd, maar *voordat* de commit definitief wordt gemaakt.

Deze hook is handig om te controleren of je commitberichten specifieke conventies of indelingen volgen. Je kunt bijvoorbeeld controleren of:

• Het bericht begint met een ticket-ID (bijvoorbeeld [JIRA-123])
• De lengte van het bericht binnen de limieten valt
• Bepaalde trefwoorden wel of niet aanwezig zijn

De hook post-commit wordt *onmiddellijk nadat* een commit succesvol is gemaakt, uitgevoerd.

In tegenstelling tot pre-commit of commit-msg kan deze hook de uitkomst van de commit niet meer wijzigen. Hij wordt vaak gebruikt voor meldingen of integraties, bijvoorbeeld voor:

• Teamleden op de hoogte brengen
• Een projectmanagementtool bijwerken
• Een build voor continue integratie (CI) starten (hoewel dit vaker met server-side hooks gebeurt)

Bij serverhooks wordt pre-receive uitgevoerd voordat verwijzingen, zoals branches of tags, in de externe repository worden bijgewerkt.

Deze hook is krachtig voor het afdwingen van belangrijke repositorybeleidsregels, zoals:

• Directe pushes naar de branch main voorkomen
• Ervoor zorgen dat alle commits zijn ondertekend
• De identiteit van de committer valideren

Als deze hook eindigt met een status die niet nul is, wordt de volledige push geweigerd.

De hook post-receive wordt uitgevoerd nadat een push de verwijzingen in de externe repository succesvol heeft bijgewerkt.

Net als post-commit kan deze hook de push niet weigeren. Deze wordt vaak gebruikt voor:

• CI/CD-pijplijnen starten
• Externe issue-trackers bijwerken
• E-mailmeldingen naar het team versturen
• Code implementeren in een stagingomgeving

Om een hook te maken, maakt u eenvoudig een bestand met de naam van de hook, bijvoorbeeld pre-commit, in de map .git/hooks/. Laten we een heel eenvoudige hook maken:

Nadat u het hookscript hebt gemaakt, moet u het uitvoerbaar maken. Anders voert Git het niet uit. Gebruik de opdracht chmod in uw terminal:

chmod +x .git/hooks/pre-commit

Elke keer dat u nu een commit probeert te maken, voert Git dit script uit!

U hebt uw eerste stap gezet in de krachtige wereld van Git-hooks!

• Git-hooks zijn scripts die acties automatiseren tijdens Git-gebeurtenissen.
• Ze staan in de map .git/hooks/ van uw repository.
• Hooks zijn client-side (op de lokale machine) of server-side (in de externe repository).
• Belangrijke hooks zoals pre-commit en pre-receive kunnen beleidsregels afdwingen door bewerkingen te blokkeren.
• Hooks zoals post-commit en post-receive zijn bedoeld voor meldingen of integraties na een actie.

Vervolgens gaan we praktische voorbeelden van specifieke hooks implementeren!