Files
cluster-knaster/deploy/gitea-runner/README.md
T
2026-10-12 01:18:10 +02:00

15 lines
1.1 KiB
Markdown

# Gitea Actions Runner
Auf dem Portainer-Host läuft bereits der Stack `gitrunner`. Das ist ein **Org-Runner**: Er bedient nur Repos der Organisation, nicht `rorapp/cluster-knaster`.
Dafür gibt es zwei Wege:
- **A:** Das Repo in die Organisation verschieben. Dann ist kein weiterer Runner nötig.
- **B:** Einen eigenen, ressourcenbegrenzten Runner auf Repo-Ebene betreiben, mit dem Stack in diesem Ordner. Er folgt dem gleichen Muster wie `gitrunner`: Swarm-Secret für den Token, Swarm-Config, `network: bridge`.
Ablauf für B:
1. In Gitea **cluster-knaster → Einstellungen → Actions → Runner → Neuen Runner erstellen**. Actions muss für das Repo aktiviert sein.
2. Swarm-Secret `gitea-runner-knaster-token` mit dem Token und Swarm-Config `gitrunner_knaster_config_v1` aus `config.yaml` anlegen.
3. Stack `gitrunner-knaster` aus `docker-compose.yml` deployen.
**Sicherheit:** Der Runner hat Zugriff auf den Docker-Socket des Hosts. Deshalb nur auf Repo-Ebene registrieren und keine Workflows aus fremden Forks ausführen. Langfristig zieht der Runner in den Infra-LXC des Clusters um.