Über GitLab
GitLab ist eine DevOps-Plattform, die Git-Repositories, Merge Requests, Issue-Tracking, Paketregistry und Continuous Integration (CI/CD) in einer einzigen Anwendung vereint. Die Community Edition (CE) ist Open Source. Sie eignet sich für Entwicklungsteams, Agenturen und kleine Unternehmen, die ihren Code und ihre Pipelines auf einem Server betreiben möchten, den sie selbst kontrollieren.
Bei der Übergabe enthält der Linux-VPS (Debian 12 oder 13, Ubuntu 20.04, 22.04 oder 24.04) GitLab CE, installiert aus dem offiziellen Repository packages.gitlab.com über das Omnibus-Paket. Für die öffentliche IP-Adresse des Servers wird ein selbstsigniertes TLS-Zertifikat mit zehn Jahren Laufzeit erzeugt. Die externe URL ist auf https://SERVER_IP gesetzt, HTTP wird auf HTTPS umgeleitet.
Das Administratorkonto heißt root. Das Initialpasswort steht in /etc/gitlab/initial_root_password. Laut Recipe sind mindestens 4 GB RAM (empfohlen: 8 GB) und 2 CPU-Kerne nötig. GitLab ist ressourcenhungrig, dimensionieren Sie den VPS also entsprechend.
Was Sie mit GitLab tun können
Offizielle Omnibus-Installation
GitLab CE wird aus dem apt-Repository von GitLab installiert und mit
gitlab-ctl reconfigurekonfiguriert. Updates laufen danach über apt.HTTPS ab Übergabe
Für die Server-IP wird in
/etc/gitlab/ssl/ein selbstsigniertes RSA-2048-Zertifikat angelegt. Nginx leitet HTTP auf HTTPS um.Generiertes Root-Passwort
Das Initialpasswort des Kontos
rootliegt in/etc/gitlab/initial_root_password. Ein bekanntes Standardpasswort gibt es nicht.Repositories, Reviews und CI/CD
Merge Requests, Issues, Wikis, Paketregistry und CI/CD-Pipelines stehen in derselben Oberfläche bereit, ohne dass Sie Drittwerkzeuge anbinden müssen.
Konfiguration in einer Datei
Alle Einstellungen laufen über
/etc/gitlab/gitlab.rb, gefolgt vongitlab-ctl reconfigure. Das lässt sich einfach versionieren und reproduzieren.
Erste Schritte mit GitLab
Von der Bestellung bis zum Produktivbetrieb in wenigen Minuten.
- 1
VPS mit GitLab bestellen
Wählen Sie einen [Linux-VPS](/vps-linux) in Paris oder Frankfurt mit mindestens 4 GB RAM (empfohlen: 8 GB). Setzen Sie im Reiter „Applications“ des Bestellformulars das Häkchen bei GitLab.
- 2
Auf die Übergabe warten und verbinden
Installation und Erstkonfiguration dauern nach dem Start mehrere Minuten. Verfolgen Sie den Fortschritt per SSH und lesen Sie danach das Root-Passwort aus.
Bashssh root@SERVER_IP tail -f /var/log/cloud-init-output.log sudo cat /etc/gitlab/initial_root_password - 3
GitLab öffnen und anmelden
Rufen Sie https://SERVER_IP auf und bestätigen Sie die Browserwarnung, die vom selbstsignierten Zertifikat stammt. Melden Sie sich mit
rootund dem ausgelesenen Passwort an und ändern Sie es anschließend in Ihrem Profil.Bashsudo gitlab-ctl status - 4
Für den Produktivbetrieb absichern
Lassen Sie einen Domainnamen auf den Server zeigen und ersetzen Sie
external_urlin/etc/gitlab/gitlab.rbdurchhttps://YOUR_DOMAIN. Aktivieren Sie Let's Encrypt (letsencrypt['enable'] = true) oder hinterlegen Sie Ihr eigenes Zertifikat und wenden Sie die Konfiguration an. Beschränken Sie den Zugriff per Firewall (Ports 22, 80 und 443) und planen Sie Backups ein.Bashsudo nano /etc/gitlab/gitlab.rb sudo gitlab-ctl reconfigure sudo gitlab-backup create
Einsatzbereiche von GitLab
Privater Git-Server fürs Team
Hosten Sie den Quellcode Ihrer Projekte auf einem europäischen Server, den Sie selbst verwalten, mit Rechten pro Gruppe und pro Projekt.
Interne CI/CD-Pipelines
Führen Sie Tests und Deployments über
.gitlab-ci.yml-Dateien aus, die zusammen mit dem Code versioniert sind, auf Ihren eigenen Runnern.Umzug von einem gehosteten Dienst
Importieren Sie Ihre Repositories von GitHub oder aus einer anderen GitLab-Instanz, um die Kontrolle über Daten und Zugriffsregeln zurückzugewinnen.
Lern- und Testumgebung
Probieren Sie GitLab-Konfiguration, Backups oder ein Versionsupgrade auf einem eigenen Server aus, bevor Sie die Produktion anfassen.
Häufige Fragen zu GitLab
Das Recipe nennt mindestens 4 GB und empfiehlt 8 GB, dazu mindestens 2 CPU-Kerne. Darunter kann die Installation scheitern oder die Oberfläche sehr langsam werden. Planen Sie 8 GB ein, wenn Sie CI/CD regelmäßig nutzen.
Mehr über GitLab
Selbstsigniertes Zertifikat ersetzen
Das mitgelieferte Zertifikat ist an die IP-Adresse gebunden, daher zeigen Browser eine Warnung an. Um sie loszuwerden, verwenden Sie einen Domainnamen (siehe /web-domains) und passen /etc/gitlab/gitlab.rb an:
Rubyexternal_url 'https://YOUR_DOMAIN' letsencrypt['enable'] = true letsencrypt['contact_emails'] = ['admin@YOUR_DOMAIN']
Führen Sie anschließend sudo gitlab-ctl reconfigure aus. Die Domain muss bereits auf den Server zeigen, und für die Validierung müssen die Ports 80 und 443 erreichbar sein.
Ressourcen und Arbeitsspeicher
GitLab startet mehrere Dienste (Puma, Sidekiq, PostgreSQL, Redis, Nginx, Gitaly). Mit 4 GB RAM läuft die Instanz für ein kleines Team, doch Swap und etwas Reserve sind sinnvoll. Wechseln Sie auf 8 GB, sobald Sie häufige Pipelines oder mehrere Dutzend Nutzer haben.
Backups und Updates
Der Befehl sudo gitlab-backup create erstellt ein Archiv der Anwendungsdaten. Sichern Sie zusätzlich /etc/gitlab/gitlab.rb und /etc/gitlab/gitlab-secrets.json, denn beide Dateien sind in diesem Archiv nicht enthalten. Für Updates verwenden Sie sudo apt update && sudo apt install gitlab-ce. Lesen Sie vorher den offiziellen Upgrade-Pfad, da GitLab mitunter Zwischenversionen vorschreibt.
