{"canonical_url":"https://engineer.company/de/glossary/gitlab/","content_markdown":"# GitLab\n\n## Was es ist\n\nGitLab ist eine einzige Anwendung rund um Git-Repositorys: Sie hostet den\nCode und ergänzt Merge Requests zur Prüfung, Issues zur Planung und ein\neingebautes CI/CD-System, das am selben Ort baut, testet und bereitstellt.\nEin Unterscheidungsmerkmal ist die Wahl des Betriebsorts. Dasselbe Produkt\ngibt es als GitLab.com, den von GitLab selbst betriebenen Dienst, als\nGitLab Self-Managed zur Installation auf eigenen Servern und als\nGitLab Dedicated, eine von GitLab für einen Kunden gehostete und gepflegte\nSingle-Tenant-Instanz in dessen bevorzugter AWS-Region.\n\nDarunter liegt gewöhnliches Git. Jedes Projekt ist ein Git-Repository, das\nsich mit den üblichen Befehlen klonen lässt und Pushes und Fetches\nunterstützt. Die Historie eines Klons ist vollständig. Alles, was GitLab\ndarüber hinaus ergänzt, von Review-Diskussionen und Issues bis zu\nPipeline-Ergebnissen und Berechtigungen, speichert GitLab selbst außerhalb\ndes Repositorys. Ein Klon enthält nichts davon.\n\nEin Merge Request ist GitLabs Bezeichnung für eine vorgeschlagene Änderung,\ndie auf das Zusammenführen wartet. Andere Plattformen nennen dieselbe Idee\nPull Request. Die Dokumentation beschreibt ihn als zentralen Ort, um Code\nzu prüfen, die Diskussion zu führen und die Änderung zu verfolgen.\nEine Seite zeigt die Beschreibung, die Codeänderungen mit Review-Kommentaren\ndirekt an den betreffenden Zeilen, den Zustand der CI/CD-Pipelines, die Berichte zur\nZusammenführbarkeit und die Liste der Commits. Ein Merge Request lässt sich\nmit einem Issue verknüpfen und kann es beim Zusammenführen automatisch\nschließen. Standardmäßig ist der Standardbranch des Projekts, meist main,\ngeschützt. Nur Personen mit der Rolle Maintainer oder höher dürfen Änderungen\nin ihn zusammenführen.\n\nDas CI/CD-System wird in der Datei `.gitlab-ci.yml` im Projektwurzelverzeichnis\nkonfiguriert. Sie deklariert Stages, Jobs und Skripte, die zusammen eine\nPipeline bilden. Stages bestimmen die Reihenfolge, etwa Bauen, dann Testen,\ndann Bereitstellen. Jobs sind die Aufgaben innerhalb jeder Stage.\nAusgeführt werden sie von GitLab Runner, einem gesonderten, in Go geschriebenen\nund als einzelne Binärdatei ausgelieferten Programm. Ein Runner verbindet\nsich mit einer GitLab-Instanz, wartet auf Jobs, führt jeden auf dem Rechner\nselbst, in einem Docker-Container oder über SSH auf einem entfernten Server\naus und meldet das Ergebnis zurück.\n\n## Warum es wichtig ist\n\nDas meiste, was ein Softwareteam zwischen dem Schreiben und Ausliefern von\nCode tut, kann in einer GitLab-Instanz stattfinden: der Code, das Review,\ndie prüfende Pipeline, das anfordernde Issue und die Aufzeichnung, wer was\nfreigegeben hat. Eine Anwendung bedeutet einen Satz von Konten und\nBerechtigungen, einen Ort zum Suchen und beständige Verknüpfungen zwischen\neinem Issue, dem zugehörigen Merge Request und der prüfenden Pipeline.\n\nDer mögliche Eigenbetrieb ist für viele Organisationen überhaupt der Grund,\nGitLab zu wählen. Darf Code die eigene Infrastruktur wegen eines Vertrags,\neiner Aufsichtsbehörde oder schlicht einer Richtlinie nicht verlassen,\nscheidet ein Hostingdienst aus. GitLab lässt sich dann innerhalb des Netzes\ninstallieren, in dem der Code bleiben muss. Die Dokumentation behandelt das\nals vollwertigen Anwendungsfall: Neben dem Linux-Paket und einem Helm-Chart\nfür Kubernetes veröffentlicht sie Referenzarchitekturen für Installationen\nmit 1.000 bis 50.000 Nutzern.\n\nDiese Kontrolle hat ihren Preis. Er wird im Betrieb bezahlt, nicht nur mit\nLizenzgebühren. Wer GitLab selbst betreibt, muss einen Server passend\nauslegen, die PostgreSQL-Datenbank und den Redis- oder Valkey-Speicher\nfunktionsfähig halten, Rechner für die Runner bereitstellen, tatsächlich wiederherstellbare\nSicherungen anlegen und Upgrades in der vom Projekt vorgeschriebenen\nReihenfolge durchlaufen. Die gehosteten Angebote übertragen diese Arbeit an\nGitLab. Beim Eigenbetrieb bleibt sie bei Ihnen.\n\n## Wie es in der Praxis aussieht\n\nDie Arbeit des Unternehmens liefert Beispiele für beide Seiten von GitLab.\n\nÜber mehrere Jahre im Data Engineering ersetzten\n[CI/CD-Verfahren auf Basis von GitHub und GitLab](/de/portfolio/saved-4000-hours-with-github-and-gitlab-ci-cd/)\nmit Bash und Python als Grundlage der Automatisierung manuelle Schritte\nsowohl in der Datenanalyse als auch in der Softwareentwicklung. Der Weg von\nder Entwicklung zur Auslieferung wurde vereinheitlicht, damit er jedes Mal\ngleich ablief und nicht je Projekt neu erfunden wurde. Die Analyse,\nlange als getrennte und stärker manuelle Welt behandelt, kam in dieselbe\nPipeline wie die Entwicklungsarbeit. Die Seite verzeichnet etwa 4.000\nersparte Stunden und verlässlicher ausgelieferte Arbeit, weil sie nicht mehr\njedes Mal etwas anders erledigt wurde.\n\nDer eigene Code des Unternehmens zeigt das andere Ende des Eigenbetriebs.\nBeim Umzug von einem fremden Hostingdienst ging er zu\n[einer selbst betriebenen Forge aus einer einzelnen Binärdatei, mit vorrangigem SSH-Zugang und ohne administrative Weboberfläche](/de/portfolio/your-code-on-your-own-hardware/).\nSie wurde nach dem Grundsatz gewählt: Je weniger Oberfläche es gibt, desto\nweniger muss verteidigt werden. Diese Forge teilt sich\n[einen Host für öffentliche Dienste mit 512 MB Arbeitsspeicher](/de/portfolio/a-whole-company-on-one-small-server/),\nvon denen etwa 464 MB nutzbar sind, mit einem Webserver für sieben Domains,\neinem Tor-Onion-Dienst, einem Gemini-Server, einem Gopher-Server und der\nSperrung von Angreifern. Die Sicherungsautomatisierung ist gesondert\nimplementiert. Ihre Implementierung ist von aktiven Sicherungen zu\nunterscheiden.\n\nKeine der beiden Seiten erwähnt GitLab. Der folgende Vergleich ist eine\neigene Rechnung dieses Artikels. GitLab nennt 8 GB Arbeitsspeicher als\nMinimum für eine Installation auf einem einzelnen Knoten. Der gesamte Host\nhat ein Sechzehntel davon. GitLab selbst betreiben zu können bedeutet,\neinen passend für GitLab ausgelegten Server zu haben. Eine kleine Forge\nfür einen einzigen Zweck ist der andere Weg, Code auf eigenen Rechnern zu\nhalten.\n\nEine minimale Pipeline-Datei zeigt den Aufbau der CI/CD-Konfiguration:\nzwei nacheinander laufende Stages mit je einem Job:\n\n```yaml\nstages:\n    - build\n    - test\n\nbuild-site:\n    stage: build\n    script:\n        - make build\n\nrun-tests:\n    stage: test\n    script:\n        - make test\n```\n\n## Wo es schiefgeht\n\n- **Ein kleiner Server macht die ganze Instanz langsam.** GitLabs\n  Dokumentation nennt 16 GB Arbeitsspeicher als Ausgangspunkt für eine\n  Installation auf einem einzelnen Knoten und 8 GB als Minimum bei\n  eingeschränktem Speicher. Sie warnt außerdem, dass Swap die Leistung unter\n  Last erheblich verschlechtern kann, und fordert, ihn möglichst\n  abzuschalten oder genügend Arbeitsspeicher vorzuhalten, damit GitLab ihn\n  nie verwendet.\n- **Eine Sicherung wird in eine Instanz eingespielt, die ihre eigenen Daten\n  nicht lesen kann.** Der Sicherungsbefehl lässt das Konfigurationsverzeichnis\n  `/etc/gitlab` aus und damit `gitlab-secrets.json`: die Schlüssel zum\n  Entschlüsseln verschlüsselter Datenbankwerte. Ohne diese Datei bleiben\n  die Werte einer wiederhergestellten Datenbank gesperrt. Die Dokumentation\n  fordert eine gesonderte Sicherung der Konfiguration, mindestens von\n  `gitlab-secrets.json` und `gitlab.rb`.\n- **Ein Upgrade überspringt einen vorgeschriebenen Zwischenstand.**\n  Upgrade-Pfade enthalten Pflichtstopps: Versionen, die vor jeder späteren\n  installiert werden müssen. Seit GitLab 17.5 liegen sie bei x.2, x.5, x.8\n  und x.11. Die Hintergrundmigrationen jedes Zwischenstands müssen fertig\n  sein, bevor das nächste Upgrade beginnt. Eine mehrere Versionen\n  zurückliegende Instanz holt daher einen Pflichtstopp nach dem anderen auf.\n- **Ein verwalteter Datenspeicher wird nicht unterstützt.** PostgreSQL ist\n  die einzige unterstützte Datenbank. Redis oder Valkey hält Sitzungen und\n  Hintergrundaufgaben und muss als eigenständige Instanz laufen.\n  Redis Cluster und serverlose Varianten von Redis und Valkey werden nicht\n  unterstützt. Ein verwalteter Clouddienst ist zulässig, sofern er zu den\n  eigenständigen Varianten gehört.\n- **Pipelines warten auf Rechner, die niemand eingeplant hat.** GitLab.com\n  bietet fertige Runner an. Bei einer selbst verwalteten Instanz stellt und\n  verwaltet der Administrator dagegen die Infrastruktur für die CI/CD-Jobs.\n  Dazu gehört, den Runnern genügend Kapazität für die Arbeitslast der\n  Organisation zu geben. Ein ausgelastetes Team mit einem kleinen Runner\n  steht dahinter Schlange.\n\n## Weiterführende Lektüre\n\n- [GitLab-Dokumentation](https://docs.gitlab.com/) — die gesamte Dokumentation\n  zur Nutzung, Installation und Administration von GitLab.\n- [Installationsanforderungen](https://docs.gitlab.com/install/requirements/)\n  — Arbeitsspeicher, CPU, Speicherplatz und unterstützte PostgreSQL- und\n  Redis-Versionen.\n- [GitLab sichern](https://docs.gitlab.com/administration/backup_restore/backup_gitlab/)\n  — was eine Sicherung enthält, was sie auslässt und wie die Geheimnisse\n  daneben aufzubewahren sind.\n- [Upgrade-Pfade](https://docs.gitlab.com/update/upgrade_paths/) — die\n  vorgeschriebenen Zwischenstände und warum die Hintergrundmigrationen\n  dazwischen fertig werden müssen.\n- [Einstieg in GitLab CI/CD](https://docs.gitlab.com/ci/) — die Datei\n  `.gitlab-ci.yml`, Stages, Jobs und Pipelines.\n- [GitLab Runner](https://docs.gitlab.com/runner/) — das Programm zur\n  Ausführung der Jobs und seine Ausführungsarten.\n\n\u003chttps://engineer.company/de/glossary/gitlab/\u003e\n","date_modified":"2026-11-08T09:42:23Z","description":"Was GitLab um Git herum bündelt, warum Teams es selbst betreiben und welcher Aufwand für Speicher, Sicherungen und Upgrades damit einhergeht.","formats":{"gemtext":"https://engineer.company/de/glossary/gitlab/index.gmi","gopher":"https://engineer.company/de/glossary/gitlab/gophermap","html":"https://engineer.company/de/glossary/gitlab/","json":"https://engineer.company/de/glossary/gitlab/index.json","markdown":"https://engineer.company/de/glossary/gitlab/index.md","pdf":"https://engineer.company/de/glossary/gitlab/index.pdf"},"kind":"page","language":"de","title":"Was ist GitLab?","url":"https://engineer.company/de/glossary/gitlab/","version":1}