82 lines
2.5 KiB
Markdown
82 lines
2.5 KiB
Markdown
# Tech Stack — git-pages
|
|
|
|
> Mitä teknologioita `git-pages/` Helm chart käyttää ja edellyttää. Tämä dokumentti koskee vain
|
|
> `git-pages/`-alikansiota monorepossa — ei juuren `gitea-ci-library`-kirjastoa.
|
|
|
|
---
|
|
|
|
## Sovellus
|
|
|
|
| Teknologia | Versio | Käyttö |
|
|
|---|---|---|
|
|
| **git-pages** (Codeberg) | `0.9.1` | Staattinen sisältö, apex index-site (`/.index`), HTTP PATCH/PUT -julkaisu |
|
|
| **Filesystem storage** | — | Sisältö PVC:llä (`/app/data`) |
|
|
| **TOML** | — | Sovellusconfig ConfigMapissa (`config.toml`) |
|
|
|
|
Image: `codeberg.org/git-pages/git-pages:0.9.1` (ei `v`-etuliitettä tagissa).
|
|
|
|
Chart ajaa `PAGES_INSECURE=1` — julkaisuvaltuutus Traefik Middlewaressä, ei forge-authia.
|
|
|
|
---
|
|
|
|
## Alusta ja verkko
|
|
|
|
| Teknologia | Versio / minimi | Käyttö |
|
|
|---|---|---|
|
|
| **Kubernetes** | 1.24+ | Deployment, Service, PVC, Secret |
|
|
| **Helm** | v3 | Chart asennus ja päivitys |
|
|
| **Traefik** | CRD `traefik.io/v1alpha1` | IngressRoute, Middleware (`basicAuth`, HTTPS-redirect) |
|
|
| **cert-manager** | — | TLS-sertifikaatti (`git-pages-tls`) |
|
|
|
|
---
|
|
|
|
## Pysyvyys
|
|
|
|
| Teknologia | Käyttö |
|
|
|---|---|
|
|
| **PersistentVolumeClaim** | Raporttisisältö (`ReadWriteOnce`) |
|
|
| **storageClass** | Instance-kohtainen (`dev-values.yaml`) |
|
|
|
|
---
|
|
|
|
## Esiehdot (klusteri)
|
|
|
|
| Resurssi | Lähde | Dokumentti |
|
|
|---|---|---|
|
|
| `git-pages-publish-auth` | Manuaalinen Secret | [secrets.md](secrets.md) |
|
|
| `git-pages-tls` | cert-manager Certificate | Automaattinen asennuksessa |
|
|
| `ClusterIssuer` | Klusteri (esim. `letsencrypt-prod`) | `dev-values.yaml` |
|
|
|
|
---
|
|
|
|
## Asennustyökalut (operaattori)
|
|
|
|
| Työkalu | Käyttö |
|
|
|---|---|
|
|
| **kubectl** | Secretin luonti |
|
|
| **openssl** | Publish-tokenin generointi (`rand -base64 24`) |
|
|
| **Docker** (`httpd:2-alpine`) | htpasswd-rivin generointi |
|
|
|
|
---
|
|
|
|
## Konfiguraatio
|
|
|
|
| Tiedosto | Kerros | Sisältö |
|
|
|---|---|---|
|
|
| `values.yaml` | Chart-vakiot | Image, resurssit, Traefik entrypointit |
|
|
| `{env}-values.yaml` | Instanssi | Host, issuer, PVC koko/storageClass |
|
|
|
|
Esimerkki: `helm upgrade --install git-pages ./git-pages -n git-pages -f dev-values.yaml`
|
|
|
|
---
|
|
|
|
## Mitä EI käytetä
|
|
|
|
| Teknologia | Syy |
|
|
|---|---|
|
|
| **Gitea `pages`-branch** | Ei Gitea git-pages -integraatiota |
|
|
| **deadnews/gitea-pages** | Ei Gitea API -hakua |
|
|
| **MinIO / S3** | Erillinen raporttivarasto — ei tämän chartin scope |
|
|
| **Gitea forge-auth / PAT** | Julkaisu BasicAuth-tokenilla (`git-pages-publish-auth`) |
|
|
| **Helm-managed publish Secret** | `publishAuth.create: false` — secret manuaalisesti |
|