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

Gitea Actions Runner

1. In Gitea: cluster-knaster → Einstellungen → Actions → Runner → Neuen Runner erstellen. Token kopieren. Actions muss für das Repo aktiviert sein.
2. Auf dem Zielhost: GITEA_RUNNER_REGISTRATION_TOKEN=<token> docker compose up -d. Alternativ als Portainer-Stack mit der Variablen.
3. In Gitea erscheint der Runner mit dem Label ubuntu-latest. Die CI (.gitea/workflows/ci.yml) läuft beim nächsten Push.

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. Vorgesehener Platz ist der Infra-LXC des Clusters. Bis der steht, ist ein Übergangshost möglich.