Files
memory/systems/gitea.md
T
2026-10-26 22:00:51 +00:00

8.2 KiB

title, category, tags, created, modified
title category tags created modified
Gitea (Git Server + CI) systems
gitea
git
ci
actions
2026-07-24 2026-09-27

Gitea (Git Server + CI)

Instanz

  • URL: git.schoen.codes (K8s Ingress, Traefik → gitea-http ClusterIP)
  • Internal: gitea-http ClusterIP (headless, None) — Port 3000/TCP, via Ingress/Traefik erreichbar
  • SSH: 10.0.30.200:22 (Cilium LoadBalancer, gitea-ssh service, NodePort 31441) — NICHT .202 (alter Wiki-Fehler)
  • Version: 1.27.0 (K8s Helm chart v12.7.0)
  • Privat: NIEMALS öffentlich machen (enthält Secrets)
  • CT108 (alte Gitea, 10.0.30.105, v1.25.5): GESTOPPT am 2026-09-17 (genehmigt). War bis zum Abend NICHT gestoppt trotz älterer Wiki-Claims — Live-Checks (v1.25.5-API-Antwort) schlugen die Papierlage. Vor dem Stop: Full-Census (31 Repos auth, 23 gemeinsam — 22 Tips identisch, dominik/memory K8s-Superset), 29 Bare-Bundle-Archive (143 MB) unter /home/debian/git-archive/ct108-final/. Letzter Live-Konsument war die Route git.familie-schoen.com im CT99999-Traefik (Upstream .105:3000) — umgebogen auf .203 (K8s), Alias-Host im K8s-Ingress ergänzt (Commit 9e9b6ee). Seither servieren BEIDE Hostnamen v1.27.0.

Repositories

Repo Zweck Clone
dominik/iac-homelab IaC (Tofu + Ansible + K8s Manifeste) /home/debian/iac-homelab auf Hermes host
dominik/hermes-skills Skill Versionierung ~/.hermes/skills/
dominik/hermes-memories MEMORY.md/USER.md Sync ~/.hermes/memories/
dominik/noris-compound-learning Noris Learnings (shareable) /home/debian/infra-compound-learning/

ArgoCD SSH Deploy Keys

  • Ed25519 SSH-Key als Gitea Deploy Key (read-only)
  • ArgoCD Secret argocd-repo-k8s-gitea mit SSH Private Key
  • known_hosts ConfigMap mit Gitea SSH Hostkey
  • 17 ArgoCD Apps via SSH (ssh://git@10.0.30.200:22/dominik/iac-homelab.git)
  • 25 ArgoCD Apps gesamt (Stand Sep 2026)

Gitea Actions CI

  • Primary Runner: vm200-host (ID 73, act_runner v0.2.13, host backend) — WORKING
  • K8s Runner (gitea NS): gitea-runner deployment (DinD sidecar + act_runner v0.2.13) — RUNNING, declare erfolgreich (Sep 2026). Vorher 4 Tage Init-crash wegen CSI RBAC Issue (siehe unten).
  • K8s Runner (schoenkitchen NS): gitea-runner StatefulSet (gleiche Architektur) — RUNNING, declare erfolgreich (Sep 2026).
  • KNOWN BUG (Gitea 1.27.0): actions_ready_job queue doesn't create action_task records for K8s-based runners via gRPC Declare. Only runner 73 (external, pre-registered) receives tasks. Fix: upgrade Gitea to 1.27.1+ or 1.28.x.
  • WARNUNG (Sep 2026): DEFAULT_ACTIONS_URL = https://gitea.com ist deprecated in Gitea 1.27.0 — fallback zu github. Helm Values setzen nur ENABLED: true; der Wert kommt vom Chart-Default. Zu fixen via Helm values override: DEFAULT_ACTIONS_URL: self.
  • No runner management API in Gitea 1.27.0 (/api/v1/admin/runners → 404). Manage via DB: gitea.action_runner table, is_disabled column, deleted for soft-delete.
  • Workflow: .gitea/workflows/rebuild-infrastructure.yml
  • Achtung: actions/checkout@v4 versucht github.com zu erreichen — muss gemapped werden
  • DinD Pitfalls: docker:27-dind creates docker.sock as directory → use TCP mode (--host=tcp://, --tls=false). act_runner:0.2.13 has no docker CLI → use nc for port check. act_runner:0.2.13 doesn't auto-register → wrapper script needed.
  • Solution Doc: docs/solutions/bug-fixes/2026-07-24-gitea-actions-k8s-runner-task-assignment-bug.md

Container Registry (OCI, seit 25.10.2026 verifiziert push+pull-fähig)

  • Repos: git.schoen.codes/v2/dominik/hermes-agent (Fleet-Agent-Image, digest-gepinnt sha256:32eda413… = Tag fleet-v1, 1,07 GB) und dominik/beacon (Iteration 1).
  • Zertifikat: Internes Wildcard *.schoen.codes via ESO/1P (git-schoen-codes-tls, template b64dec, Commit e8b006b) — Traefik serviert es per SNI. Push/CI NUR gegen git.schoen.codes; git.familie-schoen.com terminiert am externen Proxy mit LE-Cert (deckt familie-schoen.com, nicht *.schoen.codes) und erzeugt den http-Realm-Bug.
  • KNOWN BUG (Gitea 1.27.0): Token-Realm-URL wird per GuessCurrentHostURL aus Request-Headern gebaut, nicht aus ROOT_URL. Ohne X-Forwarded-Proto (öffentlicher Pfad) → realm="http://…/v2/token" → Docker stript Auth beim 301→https-Redirect → anonymes Token → Push 401 (Pull klappt, wenn Repo public). Intern hinter Traefik: Header vorhanden, Realm https.
  • Push-Runbook: (1) docker login git.schoen.codes VOR dem Push; (2) bei HTTP 499 am Manifest-PUT NICHT neu anfangen — Blobs sind idempotent drin, einfach erneut pushen; (3) kubectl port-forward überlebt keine SSH-Session und ist für Bulk-Pushes zu langsam; (4) tags/list zeigt nur Tags mit eigener Manifest-Revision — Beweis via GET /v2/…/manifests/<tag> (200).
  • Kubelet-Pull: Node-DNS löst git.schoen.codes auf; Pull-Secret agent-fleet-registry-pull (NS fleet, default-SA imagePullSecrets, out-of-band, nicht im Git). E2E: 1,07 GB in 34,6 s auf rke2-cp-01.
  • Solution Doc: docs/solutions/integrations/2026-10-25-gitea-oci-registry-push-chain.md

IaC Remotes

  • iac-homelab hat EINEN remote: origin = K8s Gitea (git.schoen.codes)
  • Alter CT108 remote wurde entfernt (CT108 decommissioned)

Hermes Agent SSH Push Key

  • Key: ~/.ssh/id_ed25519_gitea-hermes-push (hermes-agent@gitea-push)
  • 1Password: "Gitea Hermes Push Key" (ID: lqaebdtewj5xatvpzfrkag73v4)
  • Gitea Key ID: 4 (title: hermes-agent-push, user: dominik)
  • Verwendung: GIT_SSH_COMMAND="ssh -i ~/.ssh/id_ed25519_gitea-hermes-push -o StrictHostKeyChecking=no" git push ssh://git@10.0.30.202:22/dominik/iac-homelab.git HEAD:main
  • Wichtig: Gitea HTTP (Port 3000) hat keine externe IngressRoute — SSH (Port 22 via LoadBalancer) ist der einzige zuverlässige Weg für Git-Pushes von außerhalb K8s.

Known ArgoCD Issues (Sep 2026)

  • gitea app: Sync=Succeeded, Health=Progressing — Ingress hat keine LoadBalancer IP (Traefik reporting gap). Kosmetisch, Funktionalität OK.
  • gitea-config app: OutOfSync — Deployment gitea-runner driftet (manuelle Änderung am Image?). Sync würde helfen.
  • immich + immich-config apps: OutOfSync — zwei Apps zeigen auf überlappende Pfade (rendered vs roh) im iac-homelab Repo. Architektur-Issue, kein Gitea-Problem.
  • authelia app: Health=Progressing — gleiche Ingress-LB-IP Thematik wie gitea.

Incident 2026-09-27: CSI RBAC → Gitea Pod Init-Crash

  • Symptom: Gitea Pod 4+ Tage in Init:0/3, schoenkitchen runner in PodInitializing.
  • Root Cause: Ceph CSI RBD provisioner csi-attacher hatte keine Berechtigung, csinodes zu lesen → VolumeAttachment blieb pending → PVC konnte nicht mounten.
  • Fix: RBAC ClusterRole ceph-rbd-external-attacher-runner um storage.k8s.io/csinodes Resource ergänzt, provisioner Pods neu gestartet.
  • Nach Fix: Alle 24 VolumeAttachments true, Gitea Pod Running nach Pod-Delete.
  • Lesson: Bei CSI-basierten PVs immer zuerst VolumeAttachment Status prüfen, nicht nur PVC Phase.

API-Quirks (Gitea 1.27.0, verifiziert 2026-10-10)

  • PUT /repos/{owner}/{repo}/collaborators/{user} antwortet 204 und listet den User danach in GET /collaborators — ABER: permissions.pull/push/admin kommen dort als null zurück (Anzeige-Artefakt). Wirksamkeit stattdessen per ls-remote-Test oder GET /repos/{owner}/{repo}/collaborators/{user}/permission prüfen.
  • GET /admin/users/{username} → 405 Method Not Allowed. Admin-Info via POST /admins/users/search-Variante oder GET /users/{username} (öffentlich, ohne admin-Felder).
  • Basic-Auth-Login eines Users mit must_change_password=true → 403 mit klarer Meldung („You must change your password"), statt 200. Erwartetes Gate-Verhalten, kein Defekt.
  • must_change_password=true blockiert Web/API, aber NICHT Git-over-HTTPS — der Account kann sofort klonen. Wer volles Web/UI braucht, muss erst das PW wechseln.
  • DELETE /repos/{owner}/{repo}/collaborators/{user} → 204 unabhängig davon, ob je eine Collaboration existierte — kein brauchbarer Existenz-Check.