GitLab Installations- und Konfigurationsanleitung

GitLab ist eine Open-Source-Anwendung, die hauptsächlich zum Hosten von Git-Repositories verwendet wird und zusätzliche entwicklungsbezogene Funktionen wie Issue-Tracking bietet. Sie ist darauf ausgelegt, auf der eigenen Infrastruktur gehostet zu werden und bietet Flexibilität beim Einsatz als internes Repository für Ihr Entwicklungsteam, als öffentliche Schnittstelle zu Benutzern oder als Plattform für Mitwirkende, um ihre eigenen Projekte zu hosten.

Voraussetzungen

Wenn Sie Ubuntu Version 16.04 oder älter verwenden, empfehlen wir ein Upgrade auf eine neuere Version, da Ubuntu diese Versionen nicht mehr unterstützt. Diese Sammlung von Anleitungen hilft Ihnen beim Upgrade Ihrer Ubuntu-Version.

Für dieses Tutorial benötigen Sie:

• Einen Server mit Ubuntu, einen Nicht-Root-Benutzer mit sudo-Rechten und eine aktive Firewall.
• Die offiziellen GitLab-Hardwareanforderungen empfehlen mindestens:
  • 4 CPU-Kerne
  • 4 GB RAM

  Obwohl Sie möglicherweise etwas Swap-Speicher anstelle von RAM verwenden können, wird dies nicht empfohlen.

• Einen Domainnamen, der auf Ihren Server zeigt.

Schritt 1 — Installation der Abhängigkeiten

Vor der Installation von GitLab sollten die benötigten Softwarepakete installiert werden. Diese sind in den Standard-Paketquellen von Ubuntu verfügbar.

Aktualisieren Sie zunächst den lokalen Paketindex:

sudo apt update

Installieren Sie dann die Abhängigkeiten:

sudo apt install ca-certificates curl openssh-server postfix tzdata perl

Einige dieser Pakete sind möglicherweise bereits installiert. Wählen Sie bei der Postfix-Installation die Option „Internet Site“ und geben Sie Ihren Server-Domainnamen ein.

Schritt 2 — Installation von GitLab

Wechseln Sie zunächst ins /tmp-Verzeichnis:

cd /tmp

Laden Sie das Installationsskript herunter:

curl -LO https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh

Überprüfen Sie das Skript, wenn Sie möchten:

less /tmp/script.deb.sh

Führen Sie das Installationsskript aus:

sudo bash /tmp/script.deb.sh

Installieren Sie anschließend GitLab:

sudo apt install gitlab-ce

Schritt 3 — Anpassen der Firewall-Regeln

Überprüfen Sie den Status Ihrer Firewall:

sudo ufw status

Erlauben Sie HTTP-, HTTPS- und SSH-Verkehr:

sudo ufw allow http
sudo ufw allow https
sudo ufw allow OpenSSH

Überprüfen Sie den Firewall-Status erneut:

sudo ufw status

Schritt 4 — Bearbeiten der GitLab-Konfigurationsdatei

Öffnen Sie die Konfigurationsdatei:

sudo nano /etc/gitlab/gitlab.rb

Passen Sie die external_url an:

external_url 'https://your_domain'

Schritt 5 — Erste Konfiguration über das Webinterface

Öffnen Sie GitLab im Browser:

https://your_domain

Melden Sie sich als root an. Das initiale Passwort finden Sie hier:

sudo nano /etc/gitlab/initial_root_password

Verwenden Sie dieses Passwort für die Anmeldung.

Schritt 6 — Einschränkung oder Deaktivierung öffentlicher Registrierungen

Standardmäßig kann sich jeder bei Ihrer GitLab-Instanz registrieren. Um dies zu ändern:

• Gehen Sie zum Bereich Admin über das Hamburger-Menü oben.
• Klicken Sie auf Einstellungen im linken Menü.

Registrierungen deaktivieren

Um Registrierungen vollständig zu deaktivieren, deaktivieren Sie das Kontrollkästchen Registrierung aktiviert und klicken Sie auf Änderungen speichern.

Erneuerung von Let’s Encrypt-Zertifikaten

Standardmäßig erneuert GitLab Let’s Encrypt-Zertifikate alle vier Tage nach Mitternacht.

Öffnen Sie die Konfigurationsdatei:

sudo nano /etc/gitlab/gitlab.rb

Passen Sie die Erneuerung an:

letsencrypt['auto_renew'] = true
letsencrypt['auto_renew_hour'] = "12"
letsencrypt['auto_renew_minute'] = "30"
letsencrypt['auto_renew_day_of_month'] = "*/7"

Um die automatische Erneuerung zu deaktivieren, setzen Sie:

letsencrypt['auto_renew'] = false

Fazit

Sie haben nun eine funktionierende GitLab-Instanz auf Ihrem Server eingerichtet. Sie können Projekte importieren oder erstellen und die Zugriffsrechte Ihres Teams konfigurieren. GitLab wird regelmäßig aktualisiert – besuchen Sie die Projektseite für Neuigkeiten und Updates.