# 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`).