GitLab ist ein Open-Source-GIT-Repository-Manager, der auf Rails basiert und von GitLab Inc. entwickelt wurde. Es ist ein webbasierter GIT-Repository-Manager, mit dem Ihr Team an Code arbeiten, Fehler und Funktionsanfragen verfolgen und Anwendungen testen und bereitstellen kann. GitLab bietet Funktionen wie ein Wiki, Problemverfolgung, Codeüberprüfungen, Aktivitätsfeeds und Zusammenführungsverwaltung. Es kann mehrere Projekte hosten.
GitLab ist in vier Editionen verfügbar:
- Gitlab CE (Community Edition) – selbst gehostet, kostenlos und Support vom Community-Forum.
- Gitlab EE (Enterprise Edition) – selbst gehostete, kostenpflichtige App mit zusätzlichen Funktionen.
- GitLab.com - SaaS, kostenlos.
- GitLab.io - Private GitLab-Instanz, verwaltet von GitLab Inc.
In diesem Tutorial zeige ich Ihnen Schritt für Schritt, wie Sie GitLab CE (Community Edition) auf Ihrem eigenen Ubuntu 16.04 Xenial Xerus Server installieren. In diesem Tutorial verwende ich das von GitLab bereitgestellte „Omnibus“-Paket für eine einfache Installation.
Was wir tun werden:
- Pakete installieren
- Installieren Sie GitLab
- GitLab-URL konfigurieren
- SSL Let's encrypt und DHPARAM-Zertifikat generieren
- Nginx-HTTPS für GitLab aktivieren
- UFW-Firewall konfigurieren
- Führen Sie die GitLab-Installation durch
- Testen
Voraussetzungen
- Ubuntu 16.04-Server – 64 Bit
- RAM mindestens 2 GB
- Root-Berechtigungen
Schritt 1 – Erforderliche Ubuntu-Pakete installieren
Der erste Schritt besteht darin, die Pakete zu installieren, die für die GitLab-Installation benötigt werden. Bitte melden Sie sich als Root-Benutzer beim Server an und aktualisieren Sie das Ubuntu-Repository.
ssh [email protected]
apt-get update
Installieren Sie nun die Pakete einschließlich curl zum Herunterladen des GitLab-Repositorys, ca-Zertifikate und postfix für die SMTP-Konfiguration.
Installieren Sie alle Pakete mit dem folgenden apt-Befehl.
sudo apt install curl openssh-server ca-certificates postfix
Während der Postfix-Installation werden Sie nach der Konfiguration gefragt, wählen Sie 'Internet Site'.
und geben Sie dann den Serverdomänennamen ein, der zum Senden einer E-Mail verwendet werden soll.
Schritt 2 – Gitlab installieren
In diesem Schritt installieren wir GitLab mit den Omnibus-Paketen. Omnibus installiert alle Pakete, Dienste und Tools, die zum Ausführen von GitLab auf Ihrem Server erforderlich sind.
Fügen Sie das GitLab-Repository mit dem Curl-Befehl hinzu.
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash
Installieren Sie dann die GitLab CE Community Edition mit dem apt-Befehl.
sudo apt install gitlab-ce
Warten Sie, bis der Server das gitlab-Paket heruntergeladen und installiert hat. Wenn die Installation abgeschlossen ist, sehen Sie die folgenden Ergebnisse.
Schritt 3 - Haupt-URL von Gitlab konfigurieren
Jetzt sollten wir die URL konfigurieren, die für den Zugriff auf unseren GitLab-Server verwendet wird. Ich werde hier den Domainnamen „gitlab.hakase-labs.co“ für die GitLab-URL verwenden (bitte wählen Sie Ihren eigenen Domainnamen) und ich verwende HTTPS für die Zugriffssicherheit der Benutzer.
Die Hauptkonfiguration von GitLab befindet sich im Verzeichnis ‚/etc/gitlab‘. Gehen Sie in dieses Verzeichnis und bearbeiten Sie die Konfigurationsdatei „gitlab.rb“ mit vim.
cd /etc/gitlab
vim gitlab.rb
Gehen Sie in der GitLab-Konfiguration zu Zeile 9 „external_url“ und ändern Sie die URL in Ihre URL „gitlab.hakase-labs.co“.
external_url 'http://gitlab.hakase-labs.co'
Speichern Sie die Datei und verlassen Sie den Editor. Im nächsten Schritt wird HTTPS für GitLab aktiviert.
Schritt 4 – SSL-Let's-encrypt- und DHPARAM-Zertifikat generieren
In diesem Schritt aktivieren wir das HTTPS-Protokoll für GitLab. Ich werde ein kostenloses SSL-Zertifikat verwenden, das von let's encrypt für den Gitlab-Domainnamen bereitgestellt wird.
Installieren Sie das Befehlszeilentool letsencrypt mit dem Befehl apt.
sudo apt install letsencrypt -y
Generieren Sie nach Abschluss der Installation mit dem folgenden Befehl ein neues Zertifikat für den Gitlab-Domainnamen.
letsencrypt certonly -d gitlab.hakase-labs.co
Geben Sie Ihre E-Mail-Adresse für die Benachrichtigung über die Erneuerung des SSL-Zertifikats ein.
Wählen Sie 'Zustimmen' für die Nutzungsbedingungen von Let's Encrypt und warten Sie.
Wenn es fertig ist, sehen Sie das Ergebnis unten.
Neue Let’s encrypt-Zertifikatsdateien für GitLab wurden generiert. Sie finden die Zertifikatsdateien im Verzeichnis ‚/etc/letsencrypt/live‘.
Erstellen Sie als Nächstes ein neues Verzeichnis mit dem Namen „ssl“ im GitLab-Konfigurationsverzeichnis.
mkdir -p /etc/gitlab/ssl/
Und generieren Sie dhparam pem-Dateien im SSL-Verzeichnis mit dem openssl-Befehl.
sudo openssl dhparam -out /etc/gitlab/ssl/dhparams.pem 2048
Ändern Sie nun die Berechtigungen der Zertifikatsdateien auf 600.
chmod 600 /etc/gitlab/ssl/*
Das SSL Let's encrypt-Zertifikat für GitLab und das DHPARAM-Zertifikat wurden generiert.
Schritt 5 – Aktivieren Sie Nginx HTTPS für GitLab
Zu diesem Zeitpunkt haben wir die Zertifikatsdateien von Letsencrypt im Verzeichnis „/etc/letsencrypt/live“ und das DHPARAM-Zertifikat im Verzeichnis „/etc/gitlab/ssl“.
In diesem Schritt konfigurieren wir ein GitLab zur Verwendung unserer Zertifikatsdateien. Gehen Sie in das Verzeichnis „/etc/gitlab“ und bearbeiten Sie dann die Konfiguration „gitlab.rb“ mit vim.
cd /etc/gitlab/
vim gitlab.rb
Ändern Sie die externe URL so, dass sie „https“ anstelle von „http“ verwendet.
external_url 'https://gitlab.hakase-labs.co'
Fügen Sie dann die neue SSL-Konfiguration für gitlab wie unten beschrieben hinzu.
nginx['redirect_http_to_https'] = true
nginx['ssl_certificate'] = "/etc/letsencrypt/live/gitlab.hakase-labs.co/fullchain.pem"
nginx['ssl_certificate_key'] = "/etc/letsencrypt/live/gitlab.hakase-labs.co/privkey.pem"
nginx['ssl_dhparam'] = "/etc/gitlab/ssl/dhparams.pem"
Hinweis:
Wir werden die HTTP-zu-HTTPS-Umleitung in Gitlab aktivieren.
Speichern Sie die Datei und beenden Sie vim.
Jetzt müssen wir den folgenden Befehl als root ausführen, um die neue Gitlab-Konfiguration anzuwenden.
sudo gitlab-ctl reconfigure
Die Ergebnisse werden unten angezeigt.
Die HTTPS-Konfiguration für GitLab wurde abgeschlossen.
Schritt 6 – UFW-Firewall konfigurieren
In diesem Schritt aktivieren wir die UFW-Firewall. Es ist bereits auf dem System installiert, wir müssen den Dienst nur starten. Wir werden GitLab hinter der UFW-Firewall ausführen, also müssen wir die HTTP- und HTTPS-Ports öffnen.
Aktivieren Sie die UFW-Firewall mit dem folgenden Befehl.
ufw enable
Der Befehl führt den ufw-Dienst aus und fügt ihn hinzu, damit er beim Booten automatisch gestartet wird.
Öffnen Sie als Nächstes die neuen Ports ssh, HTTP und HTTPS.
ufw allow ssh
ufw allow http
ufw allow https
Überprüfen Sie nun den Firewall-Status und vergewissern Sie sich, dass ssh-, http- und https-Ports auf der Liste stehen.
ufw status
HTTP- und HTTPS-Ports sind konfiguriert.
Schritt 7 – Gitlab-Nachinstallation
GitLab wurde auf dem System installiert und läuft hinter der UFW-Firewall. In diesem Schritt werden wir einige schnelle Einstellungen vornehmen, wie das Ändern von Passwort, Benutzername und Profileinstellungen.
Öffnen Sie Ihren Webbrowser und geben Sie die Gitlab-URL ein, meine ist „gitlab.hakase-labs.co“. Sie werden auf die HTTPS-Verbindung umgeleitet.
GitLab-Root-Passwort zurücksetzen
Melden Sie sich nun mit dem Benutzer „root“ und Ihrem Passwort bei GitLab an.
Benutzernamen und Profil ändern
Klicken Sie oben rechts auf Ihr Profil und wählen Sie „Profileinstellungen“.
Tauschen Sie auf der Registerkarte „Profil“ den Standardnamen mit Ihrem Namen und die E-Mail-Adresse mit Ihrer E-Mail-Adresse aus. Klicken Sie nun auf „Profil aktualisieren“.
Klicken Sie auf die Registerkarte "Konto", ändern Sie den Benutzernamen mit Ihrem eigenen Benutzernamen. Klicken Sie dann auf „Benutzernamen aktualisieren“.
SSH-Schlüssel hinzufügen
Stellen Sie sicher, dass Sie bereits einen Schlüssel haben, wenn Sie keinen SSH-Schlüssel haben, können Sie ihn mit dem folgenden Befehl generieren.
ssh-keygen
Und Sie erhalten zwei Schlüssel, 'id_rsa' Ihren privaten Schlüssel und 'id_rsa.pub' Ihren öffentlichen Schlüssel.
Klicken Sie als Nächstes auf die Registerkarte „SSH-Schlüssel“, kopieren Sie den Inhalt der Datei „id_rsa.pub“, fügen Sie ihn in das Schlüsselfeld ein und klicken Sie auf „Schlüssel hinzufügen“.
Neuer SSH-Schlüssel wurde hinzugefügt.
Anmeldebeschränkungen und Limiteinstellungen
Klicken Sie auf das Symbol „Verwaltungsbereich“ und dann auf das Zahnradsymbol und wählen Sie „Einstellungen“.
In den „Konto- und Limiteinstellungen“ können Sie maximale Projekte pro Benutzer und in den „Anmeldebeschränkungen“ konfigurieren. Sie können den Domänennamen Ihrer E-Mail-Adresse zum weißen Listenfeld hinzufügen.
Und wenn alles fertig ist, scrollen Sie nach unten und klicken Sie auf „Speichern“.
Die grundlegende GitLab-Konfiguration ist abgeschlossen.
Schritt 8 – Testen
Abschließend werden wir einige Tests durchführen, um sicherzustellen, dass unser GitLab-System ordnungsgemäß funktioniert.
Neues Projekt erstellen
Klicken Sie oben auf das Plus-Symbol, um ein neues Projekt-Repository zu erstellen. Geben Sie Ihren Projektnamen und eine Beschreibung ein und richten Sie die Sichtbarkeitseinstellungen Ihres Projekts ein. Klicken Sie dann auf die Schaltfläche 'Projekt erstellen'.
Das neue Projekt wurde erstellt.
Erstes Commit testen und pushen
Nachdem das Projekt „howtoforge“ erstellt wurde, werden Sie auf die Projektseite weitergeleitet. Beginnen Sie nun mit dem Hinzufügen neuer Inhalte zum Repository. Stellen Sie sicher, dass Git auf Ihrem Computer installiert ist, und richten Sie den globalen Benutzernamen und die E-Mail-Adresse für Git mit dem folgenden Befehl ein.
git config --global user.name "hakase"
git config --global user.email "[email protected]"
Klonen Sie das Repository und fügen Sie eine README.md-Datei hinzu.
git clone https://[email protected]/hakase/howtoforge.git
cd howtoforge/
vim README.md
Sie werden nach dem Benutzerpasswort „hakase“ gefragt. Bitte geben Sie dasselbe Passwort ein, das Sie beim ersten Zugriff auf GitLab verwendet haben.
Übertragen Sie eine neue Datei in das howtoforge-Repository.
git add .
git commit -m 'Add README.md file by hakase-labs'
Als nächstes übertragen Sie die Änderung per Push in das Repository auf dem GitLab-Server.
git push origin master
Geben Sie Ihr Passwort ein und drücken Sie die Eingabetaste, um fortzufahren. Das Ergebnis sehen Sie unten.
Öffnen Sie nun das howtoforge-Projekt in Ihrem Webbrowser und Sie werden sehen, dass die neue README.md-Datei zum Repository hinzugefügt wurde.
Gitlab wurde auf einem Ubuntu 16.04 Xenial Xerus-Server installiert.
Einstellungen
- https://about.gitlab.com/downloads/#ubuntu1604
- https://docs.gitlab.com/ce/