PKR-Lab

40030 - Prüfung: GitLab (self-hosted) + Proxmox als Hypervisor

Quelle: pkr-lab/pkr-lab-docs/capulus/capulus-core/4-planung/40030-gitlab-hosting-proxmox-pruefung.md

Prüfung: GitLab (self-hosted) + Proxmox als Hypervisor

Stand-Hinweis (September 2026): Die Proxmox-Ablehnung in Teil 2 ist teilweise überholt. Der
homeserver hat inzwischen ~61 GiB RAM, und der Trigger „zweiter, isolierter Cluster" ist real
geworden. Umgesetzt wurde die gestaffelte Variante ohne Proxmox: KVM/libvirt-VMs für PROD (auf dem
homeserver) und ENTW (auf worker-1), siehe
40080 und
a0010. Die RAM-/CPU-Zahlen und die
GitLab-Bewertung unten sind der Stand vom Erstellungszeitpunkt.

Zwei unabhängige Fragen, gemeinsam geprüft, weil beide auf dieselbe knappe
Ressource zielen (RAM/CPU auf homeserver, 32 GB, siehe
capulus-ansible/a-betriebssystem/a0000-ubuntu-server-install.md):

  1. Kann/soll GitLab auf dem Homeserver deployt werden, oder frisst es zu
    viele Ressourcen?
  2. Ist Proxmox als Hypervisor mittlerweile sinnvoll (mehrere Cluster,
    Datenbanken vom Cluster getrennt)?

Ergebnis vorweg: (1) GitLab CE ist — anders als GitHub — echt
selbst-hostbar (Open Source, kein Enterprise-Lizenzzwang), aber real
ressourcenhungrig: offiziell min. 8 GB RAM, in der Praxis eher 6–8 GB
dauerhaft gebunden. Das ist ein Viertel des gesamten homeserver-Budgets
für eine Dauerlast, kein elastischer Worker-Task — technisch machbar,
aber ein spürbarer Eingriff. Wenn nur Git-Hosting + einfache CI gebraucht
wird, ist Forgejo/Gitea (~200–300 MB) die deutlich günstigere Alternative;
GitLab lohnt sich, wenn der volle DevOps-Funktionsumfang (Registry,
eingebaute Pipelines, Security-Scans) wirklich gebraucht wird. (2)
Proxmox ist aktuell nicht sinnvoll — die bestehende
Bare-Metal-Architektur (inkl. WoL-Power-Management) verliert mehr an
Einfachheit, als der Hypervisor an Nutzen bringt, solange nur ein Cluster
mit diesem Zuschnitt läuft. Trigger, ab wann sich das ändert, stehen in
Teil 2.


Teil 1: GitLab auf dem Homeserver

1.1 GitLab CE ist echt selbst-hostbar — anders als GitHub

Im Unterschied zu GitHub (das nur als kostenpflichtige, überdimensionierte
GitHub-Enterprise-Server-VM-Appliance selbst-hostbar ist) ist GitLab
Community Edition (CE)
vollwertig Open Source (MIT-lizenziert) und für
Selbst-Hosting gebaut — inklusive Git-Hosting, Merge Requests, Issues,
Wiki, Container-Registry und eingebauten CI/CD-Pipelines. Nur ein Teil
der Zusatzfeatures (erweiterte Security-Scans, Approval-Workflows,
Compliance-Reporting) ist der kostenpflichtigen Enterprise Edition (EE)
vorbehalten — für ein Homelab/Kleinteam-Repo ist CE funktional
vollständig.

Zwei Deployment-Wege stehen zur Wahl:

Omnibus (Docker/VM, All-in-one) Cloud-Native-Helm-Chart
Aufbau Ein Container/eine VM bündelt nginx, Puma, Sidekiq, Gitaly, Redis, Postgres ~15+ getrennte Pods (eigener Postgres-/Redis-Operator, Gitaly, Webservice, Sidekiq, Registry, KAS, …)
Für Homelab-Größe passend — geringerer Overhead von GitLab selbst für größere Installationen empfohlen; bei kleiner Nutzerzahl mehr Ressourcenbedarf als Omnibus, nicht weniger
Passt zum bestehenden Muster (argocd/apps/tech/)? als einzelner Helm-Chart mit einem Pod ja nein — würde ~15 zusätzliche Pods in den ohnehin knappen Cluster bringen

Für dieses Setup ist Omnibus die einzig sinnvolle Option — der
Cloud-Native-Chart ist für diese Cluster-Größe eine Fehlpassung.

1.2 Ressourcenbedarf konkret

GitLab CE (Omnibus) Forgejo/Gitea GitLab CE Cloud-Native-Chart
RAM offiziell min. 8 GB empfohlen (in der Praxis mit reduzierter Puma-/Sidekiq-Worker-Zahl für Ein-Personen-Nutzung auch mit ~6 GB stabil, unter ~4 GB nicht mehr offiziell unterstützt) ~150–300 MB im Leerlauf 10+ GB (Summe aller Microservice-Pods)
CPU 4 Cores empfohlen, 2 Cores mit reduzierter Worker-Zahl machbar 1 Core reicht mehrere Cores pro Pod-Gruppe
Storage Basis-Installation wenige GB, wächst mit Repos/Registry/CI-Artefakten/Job-Logs klein, wächst nur mit Repos wie Omnibus + Overhead je Microservice
Datenbank Postgres + Redis fest mitgeliefert (im selben Container/derselben VM) SQLite (klein) oder Postgres, optional eigener Postgres-/Redis-Operator, weitere Pods
CI GitLab CI (eigene YAML-Syntax), GitLab Runner separat (on-demand skalierbar) Forgejo/Gitea Actions (GitHub-Actions-Workflow-Syntax) wie Omnibus
Läuft dauerhaft oder elastisch? dauerhaft — Git-Zugriff soll jederzeit verfügbar sein, kein Kandidat für cluster-power-manager-Zu-/Abschalten dauerhaft, aber wegen geringem Fußabdruck kaum spürbar dauerhaft

Wichtig: Die 8 GB sind kein Peak-Wert, den sich GitLab mit anderen
Apps teilt — Omnibus reserviert das dauerhaft für seine eingebauten
Prozesse (Puma-Worker, Sidekiq-Concurrency, Postgres-Shared-Buffers,
Gitaly), unabhängig davon, ob gerade jemand pusht oder nicht.

1.3 Einordnung gegen bestehendes Budget

homeserver hat 32 GB RAM insgesamt, und der Cluster ist bereits eng
bemessen — siehe die Immich-OOM-Erfahrung, die erst zur Einführung von
HPAs geführt hat
(capulus-core/b-kubernetes-gitops/b0040-hpa-autoscaling.md).
8 GB dauerhaft für GitLab sind ein Viertel dieses Budgets — spürbar
größer als jede andere App aus docs/3-apps-workloads/. Es ist kein
Show-Stopper (die worker-0/1-Kapazität via WoL kann bei Bedarf
dazugeschaltet werden, siehe
capulus-ansible/2-betrieb-hardware/20020-cluster-power-manager.md),
aber es verdrängt real anderen Workload, wenn GitLab auf homeserver
selbst läuft (das dauerhaft-an-Node, siehe Teil 2.1).

1.4 GitLab vs. Forgejo — welcher Zweck rechtfertigt welchen Aufwand

1.5 Falls GitLab: konkrete Empfehlungen zur Ressourcen-Eindämmung

Nächster Schritt, falls gewünscht: Entscheidung Forgejo vs. GitLab
anhand des tatsächlichen Zwecks (1.4) treffen — das bestimmt, ob 200 MB
oder 8 GB dauerhaft reserviert werden.


Teil 2: Proxmox als Hypervisor

2.1 Ist-Zustand

homeserver, worker-0, worker-1 sind drei physische Maschinen,
bare metal, ohne Hypervisor — Ubuntu Server 26.04 LTS direkt auf der
Hardware, k3s direkt darauf (siehe
capulus-core/b-kubernetes-gitops/b0000-k3s.md). Das ist eine bewusste
Architekturentscheidung: "ein Ansible-Lauf, keine offenen Ports"
(capulus-ansible/a-betriebssystem/a0010-overview.md).

Zentral für die Bewertung: cluster-power-manager
(capulus-ansible/2-betrieb-hardware/20020-cluster-power-manager.md)
schaltet worker-0/1 per Wake-on-LAN (Magic Packet) an und per SSH
poweroff wieder aus, abhängig von der Last auf homeserver. Das
funktioniert, weil es echte, einzeln stromsparende Maschinen sind — eine
VM lässt sich zwar auch an-/ausschalten, aber dann nicht mehr per WoL
über den Netzwerk-NIC, sondern nur noch über die
Proxmox-API/den Proxmox-Host selbst (was den bewusst minimalen,
auf "nur poweroff"-beschränkten SSH-Key-Mechanismus ersetzen würde durch
Proxmox-API-Zugriff mit größerer Rechte-Oberfläche).

2.2 Warum aktuell nicht sinnvoll

2.3 Datenbanken vom Cluster trennen — geht auch ohne Proxmox

Der Wunsch dahinter (Datenbanken nicht dem k8s-Pod-Scheduling/
GitOps-Reschedule/Node-Drain ausliefern) lässt sich günstiger lösen:

Beide Wege liefern die eigentlich gewünschte Trennung, ohne die
WoL-Architektur anzufassen oder RAM für einen Hypervisor zu reservieren.

2.4 Wann Proxmox sinnvoll wird

Proxmox lohnt sich, sobald mindestens einer dieser Punkte eintritt:

  1. Echter Bedarf an einem zweiten, isolierten Cluster — z. B. eine
    Unterrichts-/Trainingsumgebung für die IT-Klasse, die absichtlich
    verwundbar/experimentierbar sein darf, ohne den Produktiv-Cluster zu
    gefährden (Fortführung des Pacman-Musters, aber als komplett
    getrenntes Cluster statt einer Flag innerhalb derselben App).
  2. Neue, dedizierte Hardware kommt dazu (ein viertes Gerät) statt
    bestehende Nodes umzuwidmen — dann ist das WoL-Argument aus 2.1
    hinfällig, weil die bestehenden drei Nodes bare metal bleiben und nur
    die neue Maschine virtualisiert wird.
  3. RAM-Upgrade auf homeserver auf ≥ 64 GB — dann ist genug Puffer
    für Hypervisor-Overhead + mehrere VMs vorhanden, ohne bestehende
    Workloads zu verdrängen.
  4. VM-Level-Snapshots/Rollback für Datenbanken werden explizit
    gebraucht
    (z. B. vor riskanten Migrationen ein komplettes
    VM-Snapshot statt nur PVC-Backup) — aktuell deckt GitOps
    (Re-Apply aus Git) + NAS-Backup
    (capulus-core/2-betrieb-hardware/20010-nas-backup.md) den
    Bedarf ab.

Solange keiner dieser Punkte zutrifft, ist der Status quo (bare metal +
gezielte Node-Pinning für DBs, siehe 2.3) die einfachere und günstigere
Lösung.


Empfehlung