moilanik
75 lines
1.7 KiB
Markdown
75 lines
1.7 KiB
Markdown
# 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`).
|