cluster-knaster/deploy/gitea-runner/README.md

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.