moilanik
28754bd410
- ADR 0004: commit-status-periaate (natiivi riittää, API vain custom-linkkiin)
- ADR 0005: provider & consumer -malli (ci-engine.yml lukittu rajapinta)
- docs/design-rationale: uusi periaate 1 "Hyödynnä natiivia",
periaate 2 korjattu (API vain tarvittaessa),
periaate 6 (MinIO→git-pages), teknologiavalinnat poistettu
- docs/config-model: isContainerBuild→isArtifactBuild, Docker-labelit poistettu
- docs/ai-context: monorepo-kuvaus (git-pages oma kokonaisuus, ohut rajapinta)
- docs/architecture, tech-stack, report-hosting, shared-scripts, workflows:
MinIO→git-pages, provider agnostinen build-ekosysteemeille
- docs/adr/: ADRt siirretty decisions/→adr/
- git-pages/docs: retention-osiot päivitetty CronJob→sidecar+HTTP API,
URL-kaava korjattu (reports/{sha8}/)
- git-pages/docs/implementation-notes: uusi (storage v2, Host-header,
whiteout, .init, PATCH+directoryt)
- git-pages/templates/init-job.yaml: post-install init (.index)
- scripts/publish-git-pages.sh: PUT-fallback poistettu (init hoitaa),
palauttaa BASE URL ilman index.html
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.