Files
OKF_CV_Website/architecture/delivery.md
T
Noel Sabia 09c42cc4dd docs: name the Gitea registry host (git.noelsabia.dev)
Gitea's built-in registry is served on the Gitea host itself; there is no
separate registry.noelsabia.dev host.
2026-10-31 19:05:57 +01:00

40 lines
1.7 KiB
Markdown

---
type: Pipeline
title: Delivery
description: Gitea Actions on the home server scan, build, push to the Gitea registry, deploy with kubectl, and version with release-please.
tags: [architecture, ci, gitea, release-please]
status: stable
generated: { by: claude-code/claude-opus-5-5, at: 2026-10-11T12:15:30Z }
---
# Pipeline
```
push to main ─► Gitea Actions (runner on the home server)
├─ go test ./...
├─ snyk test
├─ build images: gateway (with Nuxt), chapter
├─ push to the Gitea container registry (git.noelsabia.dev)
└─ kubectl apply -k deploy/
─► release-please (Gitea variant) opens a release PR; merging it tags the version
```
# Details
- **Commits:** Conventional Commits. `feat:` bumps minor, `fix:` bumps patch,
`docs:` and `chore:` do not release.
- **Image tags:** the git SHA, so every deploy is traceable.
- **Registry pull:** the cluster needs an `imagePullSecret` for the Gitea
registry (`git.noelsabia.dev`), or `/etc/containerd/certs.d/<registry>/hosts.toml` if the registry
is plain HTTP.
- **Runner permissions:** a kubeconfig for a ServiceAccount that can only
manage resources in `cv`.
- **Jobs are immutable:** changing a completed chapter's Job spec needs a
delete before apply. Rare, since finished chapters do not change.
- **Snyk:** needs a `SNYK_TOKEN` secret in Gitea.
- **Memory:** builds run on the same 4 GB server. Runner capacity 1, Node capped at 512 MB, swap as a safety net. See [server budget](/architecture/server-budget.md).
# Later
- k6 as a release gate needs a staging target. See [open questions](/decisions/open-questions.md).