git-pages helm chart

2026-06-10 05:18:58 +03:00
parent 14cf2eaeed
commit 26a8b9efa8
29 changed files with 2610 additions and 0 deletions
@@ -0,0 +1,74 @@
+# git-pages
+
+Jaettu **Gitea CI -raporttien** tallennus- ja lukupaikka: HTML-raportit (esim. Cucumber)
+commit-kohtaisiin polkuihin, selaimella avattavina linkkeinä Gitean commitin CI-job
+raportista. Kuvaus ja perustelut: [docs/](docs/).
+
+---
+
+## Käyttöönotto
+
+### 1. Secretit
+
+[docs/secrets.md](docs/secrets.md)
+
+### 2. Instanssin values-tiedosto
+
+`values.yaml` sisältää jaetut vakiot. Ympäristökohtaiset arvot omaan tiedostoon, esim.
+`dev-values.yaml` / `prod-values.yaml`:
+
+```yaml
+ingress:
+  host: pages.example.com          # julkinen host (luku + julkaisu)
+
+certificate:
+  issuerRef:
+    name: letsencrypt-prod         # cert-manager ClusterIssuer / Issuer
+    kind: ClusterIssuer
+
+persistence:
+  storageClass: ""                 # tyhjä = klusterin oletus
+  size: 5Gi
+
+retention:
+  giteaApiUrl: https://gitea.example.com
+  rules:
+    default:
+      maxAgeDays: 90
+      keepMin: 5
+    branches:
+      main:
+        maxAgeDays: 365
+        keepMin: 20
+```
+
+Esimerkki dev-ympäristöstä: [dev-values.yaml](dev-values.yaml).
+
+### 3. Helm-asennus
+
+Repojuuresta (sama `NS` kuin [docs/secrets.md](docs/secrets.md)):
+
+```bash
+NS=git-pages
+VALUES=git-pages/dev-values.yaml
+
+helm upgrade --install git-pages ./git-pages \
+  -n "$NS" --create-namespace \
+  -f "$VALUES"
+
+helm template git-pages ./git-pages -f "$VALUES"
+```
+
+---
+
+## CI-julkaisu
+
+Workflow tarvitsee vähintään:
+
+| Muuttuja | Kuvaus |
+|----------|--------|
+| `PAGES_HOST` | Sama kuin `ingress.host` (julkinen lukulinkki) |
+| `GIT_PAGES_PUBLISH_URL` | `https://{ingress.host}` |
+| `GIT_PAGES_PUBLISH_TOKEN` | Gitea Actions secret — sama arvo kuin publish-auth-secretissa |
+
+Julkaisu repossa: `scripts/publish-git-pages.sh` (dogfood: `.gitea/workflows/ci-engine.yml`).