gitea-ci-library/docs/adr/0004-commit-status.md

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.