Runner-Setup fuer Gitea Actions

act_runner auf dem VPS, steuert den Docker-Daemon des Hosts ueber den
Socket. Registrierung ueber die interne Adresse http://gitea:3000 im Netz
gitea-ci - die oeffentliche Domain ist aus Containern heraus nicht
erreichbar (NAT-Hairpin, host-gateway zusaetzlich von der Firewall
geblockt).

Bewusst nicht im Netz nginx-proxy-manager_default: der Runner spricht mit
Gitea, nicht mit dem Proxy.

.env und data/ bleiben aussen vor, beide enthalten Runner-Credentials.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
2026-08-20 19:17:55 +02:00
commit 2477365763
5 changed files with 165 additions and 0 deletions

33
docker-compose.yml Normal file
View File

@@ -0,0 +1,33 @@
services:
runner:
image: gitea/act_runner:latest
container_name: gitea-runner
restart: unless-stopped
environment:
# Interne Adresse ueber das gemeinsame Netz gitea-ci.
# NICHT die oeffentliche Domain: Gitea laeuft auf demselben Host, der
# Weg ueber die oeffentliche IP findet nicht zurueck (NAT-Hairpin)
# und die Registrierung haengt still.
GITEA_INSTANCE_URL: http://${GITEA_CONTAINER}:${GITEA_PORT}
GITEA_RUNNER_REGISTRATION_TOKEN: ${GITEA_RUNNER_REGISTRATION_TOKEN}
GITEA_RUNNER_NAME: vps-runner
# Ohne das wird die gemountete config.yaml ignoriert.
CONFIG_FILE: /config.yaml
GITEA_RUNNER_LABELS: ubuntu-latest:docker://catthehacker/ubuntu:act-latest
volumes:
- ./data:/data
- ./config.yaml:/config.yaml:ro
# Der Runner steuert den Docker-Daemon des Hosts.
# ACHTUNG: das entspricht Root-Rechten auf dem VPS.
- /var/run/docker.sock:/var/run/docker.sock
networks:
- gitea-ci
# Bewusst NICHT nginx-proxy-manager_default: der Runner spricht mit Gitea,
# nicht mit dem Proxy. Das Netz wird einmalig angelegt mit
# docker network create gitea-ci
# und muss auch in Gitea's Compose-File stehen, sonst faellt Gitea beim
# naechsten Recreate wieder heraus.
networks:
gitea-ci:
external: true