init: git-pages init job, ADR 0004, docs, remove PUT fallback
- 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ä
This commit is contained in:
@@ -0,0 +1,25 @@
|
||||
# 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
|
||||
|
||||
1. Gitea Actionsin automaattinen commit-status on ensisijainen.
|
||||
2. API:a kutsutaan vain tarpeeseen: linkki ulkoiseen raporttiin.
|
||||
3. Jokainen API-kutsussa käytettävä `context`-avain on uniikki.
|
||||
4. 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.
|
||||
Reference in New Issue
Block a user