Git-hooks på serversiden

I den foregående lektion lærte vi om Git-hooks på klientsiden. Nu skal vi se nærmere på serverside-hooks, som fungerer på selve Git-serveren.

Disse hooks er effektive værktøjer til at håndhæve politikker for hele lageret og automatisere opgaver, før eller efter ændringer accepteres i det centrale lager.

Den vigtigste forskel mellem hooks på klientsiden og serversiden er, hvor de kører:

• Hooks på klientsiden: Kører på din lokale maskine før handlinger som commit eller push. De hjælper med at håndhæve lokale bedste praksisser.
• Hooks på serversiden: Kører på den centrale Git-server, efter du har pushet ændringer, men før de er fuldt integreret. De sikrer, at regler for hele repositoriet overholdes af alle.

Hooks på serversiden giver en stærkere garanti for, at alle bidragydere følger reglerne.

Hooks på serversiden ligger i mappen hooks i dit bare repository på serveren.

Et bare repository er et repository uden en arbejdsmappe – det indeholder kun Git-metadata. Når du pusher til en remote, pusher du til et bare repository.

Ligesom hooks på klientsiden er de eksekverbare scripts, som Git kører på bestemte tidspunkter i arbejdsgangen.

Hooket pre-receive er et af de mest brugte hooks på serversiden. Det kører én gang pr. push, før referencer som branches eller tags opdateres.

Det modtager en liste over alle referencer, der pushes, samt deres gamle og nye commit-id'er. Hvis dette script afsluttes med en status, der ikke er nul, afvises hele push-handlingen, og ingen referencer opdateres.

Det gør hooket velegnet til at håndhæve globale politikker.

Hooket pre-receive er perfekt til:

• Håndhævelse af navngivningskonventioner for branches: Alle nye branches skal f.eks. begynde med "feature/", "bugfix/" osv.
• Validering af commit-beskeder: Sikre, at alle commit-beskeder indeholder et ticket-id eller følger et bestemt format.
• Forhindring af push til beskyttede branches: Blokere direkte push til main eller develop.
• Kontrol af kode for følsomme oplysninger: Grundlæggende scanning efter legitimationsoplysninger.

Her er et konceptuelt eksempel på et pre-receive-script, der forhindrer direkte push til branchen main. Hvis nogen forsøger at pushe til main, bliver push-handlingen afvist.

Scriptet placeres som pre-receive i serverens bare repositorys mappe hooks og gøres eksekverbart.

Hooket update minder om pre-receive, men kører én gang for hver reference, der opdateres af en push-handling.

Det tager tre argumenter: referencens navn, det gamle objektnavn og det nye objektnavn. Hvis et update-script afsluttes med en status, der ikke er nul, afvises kun opdateringen af den pågældende reference.

Det giver mere detaljeret kontrol over opdateringer af individuelle branches.

Hooket update er nyttigt til:

• Håndhævelse af fast-forward-merges: Forhindre ikke-fast-forward-push til bestemte branches og dermed sikre en lineær historik.
• Implementering af detaljeret adgangskontrol: Tillade bestemte brugere kun at pushe til bestemte branches.
• Logning af opdateringer: Registrere hver branch-opdatering til revisionsformål.
• Forhindring af force-push: Sikre, at historikken ikke omskrives på kritiske branches.

Sådan implementerer du hooks på serversiden:

1. Få adgang til serveren: Du skal have SSH-adgang eller tilsvarende adgang til repositoriet på Git-serveren.
2. Find mappen hooks: Gå til mappen .git/hooks i dit bare repository.
3. Opret eller rediger scripts: Skriv dit hook-script, f.eks. pre-receive eller update.
4. Gør scriptet eksekverbart: Sørg for, at scriptet har køretilladelser, f.eks. chmod +x pre-receive.

Husk, at disse ændringer påvirker alle, der arbejder med repositoriet.

Når du arbejder med hooks på serversiden:

• Hold dem enkle: Kompliceret logik kan være svær at fejlsøge og vedligeholde.
• Brug versionsstyring til hooks: Overvej at gemme dine hook-scripts i et separat repository og implementere dem på dine Git-servere for at sikre ensartethed.
• Test grundigt: Sørg for, at dine hooks ikke utilsigtet blokerer legitime arbejdsgange.
• Tag højde for ydeevnen: Hooks kører ved hver push, så undgå ressourcekrævende operationer.

De er effektive, så brug dem med omtanke!

Du har udforsket mulighederne i Git-hooks på serversiden! Vi har lært:

• Hooks på serversiden håndhæver politikker på den centrale Git-server.
• pre-receive kører én gang pr. push og er velegnet til globale kontroller.
• update kører én gang pr. reference og er velegnet til detaljeret kontrol.
• Implementeringen består i at placere eksekverbare scripts i det bare repositorys mappe hooks.

Disse hooks er afgørende for at bevare kodekvalitet og ensartede arbejdsgange i teammiljøer. Bliv ved med at øve dig!