moilanik
b841496717
- ADR 0004: commit-status-periaate (API vain tarvittaessa, natiivi riittää) - git-pages/docs/implementation-notes.md: tekniset huomiot - init-job.yaml: post-install hook luo placeholderin (.index olemassa) - values.yaml: initJob.enabled default - publish-git-pages.sh: poistettu PUT-fallback (init job hoitaa) - README: maininta automaattisesta initistä
974 B
974 B
4. Commit-statusviestit — periaate
Päätös
Gitea Actions näyttää jobien tilan (checkmark, risti, spinner) commit-näkymässä automaattisesti. Tämä on ensisijainen tapa, eikä sitä korvata.
Commit-status API:a (/api/v1/repos/{owner}/{repo}/statuses/{sha}) käytetään
vain kun natiivi toiminta ei riitä — ensisijaisesti custom-raporttilinkin
välittämiseen commit-näkymään.
Periaatteet
- Gitea Actionsin automaattinen commit-status on ensisijainen.
- API:a kutsutaan vain tarpeeseen: linkki ulkoiseen raporttiin.
- Jokainen API-kutsussa käytettävä
context-avain on uniikki. - State-arvojen on oltava Gitea API:n valideja (
success,failure,pending,error,warning).
Tausta
Jenkins-versiossa jokainen build-vaihe raportoi APIin, koska Jenkins ei tarjonnut natiivia commit-statusnäkymää. Gitea Actionsissa tämä tulee automaattisesti — sama tieto kahdesta paikasta aiheuttaa melua eikä lisää arvoa.