Mitä ovat Git-hooks ja miten niitä käytetään?

Question

Accepted Answer

**Git-hooks** ovat skriptejä, joita Git suorittaa **automaattisesti** tietyissä kohdissa Git-työnkulkua (ennen/jälkeen committeja, pusheja, mergejä jne.). Ne mahdollistavat automaation — standardien täytäntöönpanon, tarkistusten suorittamisen ja toimien käynnistämisen — ja niitä käytetään laajasti koodin laadun ja CI-integraation varmistamiseen.

## Mitä hookit ovat

```text
Hooks are executable scripts in .git/hooks/ (or managed by tools) that Git runs on EVENTS:
  CLIENT-SIDE (local):
    pre-commit   → before a commit is created (lint, format, run quick tests)
    commit-msg   → validate/format the commit message
    pre-push     → before pushing (run tests, prevent pushing broken code)
    post-merge/checkout → after merge/checkout (e.g. reinstall dependencies)
  SERVER-SIDE (on the remote):
    pre-receive / update → enforce policies on push (reject bad pushes)
    post-receive → trigger deployment/CI/notifications after a push
```

## Yleisiä käyttötapauksia

```text
✓ pre-commit → LINT and FORMAT code; run quick tests; block secrets/debug code
  → catch issues BEFORE they're committed (fast feedback, consistent quality)
✓ commit-msg → enforce message format (e.g. Conventional Commits)
✓ pre-push → run the test suite → don't push failing code
✓ server-side → enforce policies; trigger CI/CD and deployments
```

## Hookien hallinta tiimissä

```text
⚠️ .git/hooks/ is LOCAL and NOT committed → hooks aren't shared automatically.
To share hooks across a team, use tools:
  → HUSKY (JS ecosystem), pre-commit (Python framework), lefthook, etc.
  → these version hooks in the repo and install them for everyone
→ Combined with CI: hooks give FAST LOCAL feedback; CI is the enforced safety net
  (hooks can be bypassed with --no-verify, so CI must also enforce).
```

## Miksi se on tärkeää

Git-hookien ymmärtäminen on arvokas senior-tason osaaminen **laaduntarkistusten ja työnkulkutoimien automatisoinnille**, joten se on hyödyllistä koodin laadun säilyttämiseen ja CI/CD-integraatioon.

Hookit mahdollistavat **automaation Git-tapahtumissa** — skriptit suoritetaan automaattisesti ennen/jälkeen committeja, pusheja, mergejä jne. — mitä käytetään laajasti standardien täytäntöönpanoon ja ongelmien varhaiseen havaitsemiseen.

Yleisimmin käytetty ja arvokkain käyttötapaus on **pre-commit-hook lintauksen, formatoinnin, nopeien testien ja salaisuuksien havaitsemisen suorittamiseen ennen committia** — se tarjoaa nopean palautteen ja varmistaa johdonmukaisen laadun automaattisesti (niin että ongelmat kiinnitetään commit-aikana eikä myöhemmin CI:ssä tai review-prosessissa), mikä on erittäin suosittu käytäntö.

Muut käyttötapaukset (commit-msg-hookit, jotka pakottavat viestikonventioita kuten Conventional Commits, pre-push-hookit, jotka suorittavat testejä viallisen koodin pushausta varten, ja palvelimen puolen hookit, jotka pakottavat käytäntöjä tai käynnistävät CI/CD:tä ja deploymenteja) laajentavat automaation koko työnkulkuun.

Praktisen **tiimin hallinta** -näkökulman ymmärtäminen on tärkeää: `.git/hooks/` on lokaali eikä **ole committissa**, joten hookit eivät jaa automaattisesti — niiden jakaminen tiimissä vaatii työkaluja kuten **Husky, pre-commit tai lefthook**, jotka versioivat hookit repositoriossa ja asentavat ne kaikille.

Ratkaisevasti, ymmärrys siitä, että hookit **voidaan ohittaa** (`--no-verify`) tarkoittaa, että ne tarjoavat nopean *paikallisen* palautteen mutta **CI:n on myös täytäntöönpantava** tarkistukset oikeana turvaverkona — avainhuomio puolustuksesta syvyydessä (paikalliset hookit nopeutta varten, CI täytäntöönpanoa varten).

Koska laaduntarkistusten ja työnkulkutoimien automatisointi parantaa koodin laatua ja johdonmukaisuutta, ja koska Git-hookit (etenkin pre-commit paikallistarkistuksille, hallittuja työkaluilla ja täydennetty CI:llä) ovat laajalti käytetty mekanismi tälle, Git-hookien ymmärtäminen — mitä ne ovat, yleiset käyttötapaukset, tiimin hallinta työkaluilla ja niiden suhde CI:hin — on arvokas senior-tason osaaminen automatisoidun, laadukkaaseen kehitykseen keskittyvän työnkulun rakentamiselle, mikä heijastaa käytäntöjä, joita käytetään ammatillisissa tiimeissä laadun säilyttämiseen.