docs(runner): add runtime environment documentation and fix Helm guide

Fix chart values (enabled, giteaRootURL, existingSecret), add log level
config, and document runner architecture: containers, services, DinD,
labels, and Jenkins comparison.

README.md

@@ -12,8 +12,6 @@ Hae token Giteasta:
 - **Organization-taso:** Org → Settings → Actions → Runners → Create new runner
 - **Globaali (site admin):** Site Admin → Actions → Runners → Create new runner
 
-Token on kertakäyttöinen — käytä heti.
-
 ### 2. Asenna runner
 
 ```bash
@@ -23,26 +21,53 @@ GITEA_ACTIONS_NAMESPACE="gitea-actions"
 
 helm repo add gitea https://dl.gitea.com/charts
 helm repo update
-helm upgrade --install act-runner gitea/gitea-act-runner \
-  --set gitea.url="$GITEA_URL" \
-  --set gitea.token="$GITEA_ACTIONS_TOKEN" \
+
+kubectl create secret generic act-runner-token \
+  --from-literal=token="$GITEA_ACTIONS_TOKEN" \
+  --namespace "$GITEA_ACTIONS_NAMESPACE" \
+  --dry-run=client -o yaml | kubectl apply -f -
+
+helm upgrade --install act-runner gitea/actions \
+  --set enabled=true \
+  --set giteaRootURL="$GITEA_URL" \
+  --set existingSecret=act-runner-token \
+  --set existingSecretKey=token \
+  --set-string 'statefulset.runner.config=log:
+  level: info
+cache:
+  enabled: false
+container:
+  require_docker: true
+  docker_timeout: 300s' \
   --namespace "$GITEA_ACTIONS_NAMESPACE" \
   --create-namespace
 ```
 
+Oletus-lokitaso on `debug` — suositeltu `info`. Näkee jobien aloitukset ja valmistumiset ilman konttikerrosten purkua (Downloading/Extracting-spämmiä). `debug` on tarpeen vain vianselvityksessä.
+
 ### 3. Varmista
 
 ```bash
 kubectl get pods -n gitea-actions
-# → act-runner-xxx  Running
+# → act-runner-runner-0  2/2  Running
+```
+
+Gitean puolella runner ilmestyy Active-tilaan pienellä viiveellä:
+
+```
+Site Admin → Actions → Runners  (tai Org → Settings → Actions → Runners)
+# → act-runner-runner-0  Active  ubuntu-latest
 ```
 
 Tämän jälkeen `.gitea/workflows/ci.yml` triggeröityy automaattisesti pushista.
 
+Lisätietoa runnerin toiminnasta, konteista ja DinD:stä: [docs/runner.md](docs/runner.md)
+
 ### Muuta
 
 | Muuttuja | Kuvaus |
 |----------|--------|
-| `gitea.url` | Gitea-palvelimen osoite (esim. `https://gitea.example.com`) |
-| `gitea.token` | Rekisteröintitoken (kts. kohta 1) |
-| `runner.labels` | Mukautetut labelit (oletus: `ubuntu-latest`) |
+| `giteaRootURL` | Gitea-palvelimen osoite (esim. `https://gitea.example.com`) |
+| `existingSecret` | Kubernetes secretin nimi, jossa token |
+| `existingSecretKey` | Avain secretin sisällä |
+| `statefulset.runner.labels` | Mukautetut labelit |