f00a0 - Tailscale-Runner-PoC — erreicht ein GitHub-Runner ArgoCD und ENTW?
Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/f-cicd-automatisierung/f00a0-tailscale-runner-poc.md
Tailscale-Runner-PoC — erreicht ein GitHub-Runner ArgoCD und ENTW?
.github/workflows/tailscale-poc.yml ist die Diagnose für die
Promotion-Kette (Phase 0, Schritt 0.8 in
40080): Kann ein GitHub-Actions-Cloud-Runner per Tailscale dem
Tailnet beitreten und die nicht öffentlich erreichbaren ArgoCD-Instanzen ansprechen? Das Gate der Kette
(24 h gesund auf ENTW, 2 h auf TECH) braucht genau diese Verbindung. Der Workflow läuft nur manuell.
Ergebnis des ersten Laufs (2026-09-20) und was daraus folgt
Der erste Lauf mit der ursprünglichen Fassung schlug im Schritt „Reach ArgoCD“ mit HTTP 000 fehl. Der
Beitritt ins Tailnet selbst klappte: der Runner erschien als Gerät des Benutzers (nicht getaggt) und sah
homeserver, worker-1 und die übrigen Geräte. Die Untersuchung danach ergab zwei Ursachen und eine offene Frage:
| Befund | Beleg |
|---|---|
Der PoC sprach das falsche Ziel an. ArgoCD läuft per NodePort im Klartext (server.insecure), https://…:30443 wird zurückgesetzt, auch direkt im LAN. Richtig ist http://…:30080. |
curl vom Arbeitsplatz: https://192.168.178.94:30443 → Verbindung zurückgesetzt, http://192.168.178.94:30080 → 200 |
Der Homeserver bewirbt das LAN-Subnetz 192.168.178.0/24 ins Tailnet. Damit sind beide ArgoCD-Instanzen (192.168.178.94:30080, ENTW 192.168.178.100:30080) über eine Route erreichbar, ohne Änderung an worker-1. |
tailscale status --json auf dem Homeserver: PrimaryRoutes: 192.168.178.0/24 |
Offen: ob die ACL dem Runner die Verbindung erlaubt. Die Grants (40080) erlauben Mitgliedern nur tcp:443 auf die Cluster-Knoten. Vom Arbeitsplatz aus liefen alle Ports der Tailnet-Adresse des Homeservers in ein Timeout (auch 22 und 443), das LAN dagegen antwortete, ein Rückschluss auf den Runner ist daher nicht möglich. |
Portprobe 100.74.0.59, 100.124.213.94 |
Die neue Fassung des Workflows testet deshalb jeden Weg einzeln und gibt eine Tabelle aus. Sie schlägt erst am Ende
fehl, und nur dann, wenn ein für die Kette nötiger Weg fehlt.
Zweiter Lauf (2026-09-20, neue Fassung): tailscale status meldete Logged out, alle Wege zu/gefiltert. Das war
kein ACL-Problem, sondern mein Fehler im Workflow: args: --accept-routes setzte das Flag ein zweites Mal
(die Action übergibt es bereits selbst), tailscale up brach mit invalid boolean flag accept-routes: flag provided multiple times ab, und die Action wertet das nach ihren Wiederholungen nicht als Fehler: der Beitritts-Schritt war
grün, der Runner aber nie angemeldet. Behoben (Flag entfernt) und abgesichert: ein eigener Schritt bricht jetzt mit
klarer Meldung ab, wenn der Runner nicht Running ist. Aussagen zur ACL sind aus diesem Lauf nicht ableitbar.
Was der Workflow prüft
| Weg | Ziel | Nötig? | Nötiger Grant |
|---|---|---|---|
hub-lan |
Hub-ArgoCD https://argocd.tech.homeserver/api/version (Zertifikat gegen die Root-CA geprüft) |
ja | 192.168.178.94, tcp:443 |
entw |
ENTW-ArgoCD https://argocd.dev.homeserver/api/version (Zertifikat gegen die Root-CA geprüft) |
ja | 192.168.178.100, tcp:443 |
smoke |
ENTW-Ingress 192.168.178.100:80 mit Host whoami.dev.homeserver |
optional (Smoke-Checks) | 192.168.178.100, tcp:80 |
hub |
Hub über die Tailnet-Adresse des Homeservers, nur TCP-Probe auf 443 | nur Diagnose | tag:tech-node, tcp:443 |
Die Tailscale-Action nimmt Subnet-Routen selbst an (--accept-routes). Ein zusätzliches args: --accept-routes im
Workflow ist ein Fehler, siehe unten. /api/version ist bei ArgoCD ohne Anmeldung erreichbar. Vor der Probe prüft der
Workflow, dass der Runner wirklich verbunden ist (BackendState = Running).
Voraussetzungen
| Was | Wo |
|---|---|
Repo-Secrets TS_OAUTH_CLIENT_ID und TS_AUDIENCE |
GitHub → Settings → Secrets. Client ID und Audience einer Federated Identity (Trust credentials) aus dem Tailscale-Admin-Panel, Einrichtung siehe Promotion-Kette → Netzweg. Ein Auth-Key taugt hier nicht: einmalig verwendbare Keys sind nach dem ersten Lauf verbraucht, alle anderen laufen nach höchstens 90 Tagen ab (der Beitritt scheiterte danach dauerhaft mit NeedsLogin). |
| ACL-Grant für den Runner | siehe Promotion-Kette → Netzweg: empfohlen ein Tag tag:ci mit Grant auf die beiden LAN-Adressen; Grundlagen in c0010 → ACL-Konfiguration |
Freigegebene Subnet-Route 192.168.178.0/24 des Homeservers |
Tailscale-Admin-Panel (ist freigegeben) |
Ausführen und Ergebnis
GitHub → Actions → „Tailscale Runner PoC“ → Run workflow. Ausgabe der Probe, lokal vom Arbeitsplatz im LAN
ausgeführt (dort gilt keine Runner-ACL, die Tailnet-Adresse filtert aber trotzdem):
hub 100.74.0.59:443 TCP zu/gefiltert HTTP - (nur Diagnose)
hub-lan argocd.tech.homeserver:443 TCP offen HTTP 200 "Version":"v3.5.5"
entw argocd.dev.homeserver:443 TCP offen HTTP 200 "Version":"v3.5.5"
smoke 192.168.178.100:80 (whoami.dev) TCP offen HTTP 200 (Smoke-Tests, optional)
OK: hub-lan und entw erreichbar - die Promotion-Kette kann die Gates auswerten.
OK = die Kette kann die Gates auswerten; Schritt 0.8 in 40080 ist erledigt. Die Skriptlogik ist lokal
geprüft; die Fassung wurde noch nicht auf GitHub ausgeführt (der GitHub-Lauf nutzt die Datei auf main), der
Netzweg des Runners ist also weiter unbestätigt.
Troubleshooting
| Symptom | Ursache / Lösung |
|---|---|
| Schritt „Connect runner to tailnet“ scheitert mit Auth-Fehler | OAuth-Client gelöscht, Secret falsch kopiert oder Scope auth_keys:write bzw. Tag tag:ci fehlt am Client: Client prüfen, Secrets ersetzen. |
Schritt „Connect …“ grün, aber NeedsLogin / Logged out / „Tailscale nicht verbunden“ |
tailscale up ist im Log des Verbindungsschritts still gescheitert (Action meldet trotzdem Erfolg). Dort nach der Fehlermeldung suchen: doppeltes Flag (args: nicht für --accept-routes nutzen), OAuth-Client ohne Recht auf tag:ci, tag:ci nicht in tagOwners. |
hub-lan/entw: TCP zu/gefiltert (Timeout) |
ACL erlaubt den Runner nicht: Grant auf die LAN-Adresse und den Port ergänzen. Ein Timeout (statt sofortiger Ablehnung) ist typisch für gefilterten Verkehr. |
hub-lan/entw: sofort abgelehnt |
Die Route kommt an, aber der Dienst antwortet nicht: läuft ArgoCD, antwortet der Traefik-Ingress (argocd.tech.homeserver, argocd.dev.homeserver) mit gültigem Zertifikat? Bei ENTW: ssh [email protected] 'sudo virsh list --all', VM muss running sein. |
| Route nicht sichtbar (Fehler „no route“) | Die Subnet-Route ist im Admin-Panel nicht freigegeben oder der Runner ist nicht verbunden (siehe Zeile darüber). |
hub (Tailnet-Adresse) filtert, hub-lan geht |
erwartbar, wenn nur das Subnetz freigegeben ist. Die Kette nutzt hub-lan. |
| Workflow bricht mit „FEHLGESCHLAGEN“ ab | Meldung des letzten Schritts: mindestens hub-lan oder entw ist nicht erreichbar, siehe die Zeilen darüber. |