So installieren Sie GitLab Community Edition (CE) 11.x unter Ubuntu 18.04 LTS

• Voraussetzungen
• Schritt 1: Führen Sie grundlegende Aufgaben zum Hosten von GitLab CE aus
• Schritt 2: Installieren Sie die erforderlichen Abhängigkeiten
• Schritt 3: Richten Sie das GitLab APT-Repo ein und installieren Sie GitLab CE
• Schritt 4: Aktivieren Sie den HTTPS-Zugriff, indem Sie ein Let's Encrypt SSL-Zertifikat integrieren

Seit GitHub von Microsoft übernommen wurde, haben einige Entwickler geplant, ihre eigenen Code-Repositorys von github.com auf eine alternative selbst gehostete Lösung zu migrieren. GitLab Community Edition (CE) ist die häufigste Wahl.

Als hochentwickelte und flexible Lösung kann GitLab CE mit verschiedenen Methoden bereitgestellt werden. Hier wird jedoch nur die offiziell empfohlene Methode, die Installation des Omnibus-Pakets, behandelt.

Voraussetzungen

• Eine neue Vultr Ubuntu 18.04 LTS x64-Serverinstanz mit mindestens 4 GB Speicher. 8 GB oder mehr werden empfohlen, um bis zu 100 Benutzer zu bedienen. Angenommen, die IPv4-Adresse lautet 203.0.113.1.
• Ein Sudo-Benutzer .
• Eine Domain gitlab.example.com, die auf die oben erwähnte Instanz verweist.

Hinweis: Wenn Sie auf Ihrer eigenen Serverinstanz bereitstellen, müssen Sie alle Beispielwerte durch tatsächliche Werte ersetzen.

Schritt 1: Führen Sie grundlegende Aufgaben zum Hosten von GitLab CE aus

Starten Sie ein SSH-Terminal und melden Sie sich als Sudo-Benutzer bei Ihrer Ubuntu 18.04 LTS x64-Serverinstanz an.

Fügen Sie eine Swap-Partition hinzu und optimieren Sie die Swappiness-Einstellung

Bei der Bereitstellung von GitLab CE 11.x auf einem Computer mit 4 GB Arbeitsspeicher muss eine 4-GB-Swap-Partition eingerichtet werden, um einen reibungslosen Betrieb zu gewährleisten:

sudo dd if=/dev/zero of=/swapfile count=4096 bs=1M
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile   none    swap    sw    0   0' | sudo tee -a /etc/fstab
free -m

Hinweis: Wenn Sie eine andere Servergröße verwenden, kann die Größe der Auslagerungspartition variieren.

Für die Systemleistung Zwecke wird empfohlen , wie die Kernel-swappiness Einstellung auf einen niedrigen Wert zu konfigurieren 10:

echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
sudo sysctl -p
cat /proc/sys/vm/swappiness

Die Ausgabe des catBefehls wird sein 10.

Richten Sie den Hostnamen und den vollqualifizierten Domänennamen (FQDN) des Computers ein.

Verwenden Sie die folgenden Befehle, um einen Hostnamen gitlabund einen vollqualifizierten Domänennamen gitlab.example.comfür den Computer einzurichten :

sudo hostnamectl set-hostname gitlab
sudo sed -i "1 i\203.0.113.1 gitlab.example.com gitlab" /etc/hosts

Sie können die Ergebnisse bestätigen:

hostname
hostname -f

Ändern Sie die Firewall-Regeln

Erlaube eingehenden SSH-, HTTP- und HTTPS-Verkehr

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

Aktualisieren Sie das System

sudo apt update
sudo apt upgrade -y && sudo shutdown -r now

Während des Upgrades werden Sie möglicherweise darüber informiert, dass die aktuell installierte Version der Grub-Konfigurationsdatei lokal geändert wurde. Da wir für die Änderung eigentlich nicht verantwortlich sind UP, markieren Sie die install the package maintainer's versionOption mit dem Pfeil und drücken Sie dann ENTER.

Wenn das System wieder betriebsbereit ist, melden Sie sich erneut als derselbe Sudo-Benutzer an, um fortzufahren.

Schritt 2: Installieren Sie die erforderlichen Abhängigkeiten

Vor der Installation von GitLab CE müssen Sie die erforderlichen Abhängigkeiten installieren:

sudo apt install -y curl openssh-server ca-certificates

Wenn Sie Postfix zum Senden von Benachrichtigungsnachrichten verwenden möchten, müssen Sie Postfix installieren:

sudo apt install -y postfix

Während der Installation wird möglicherweise ein Konfigurationsbildschirm angezeigt:

1. Drücken Sie TABdie markieren <OK>Taste auf dem ersten Bildschirm, und drücken Sie dann ENTER.
2. Wählen Sie Internet Siteund drücken Sie ENTER.
3. mail nameGeben Sie für das Feld den FQDN Ihres Servers ein gitlab.example.comund drücken Sie ENTER.
4. Wenn andere Bildschirme angezeigt werden, drücken Sie ENTER, um die Standardeinstellungen zu übernehmen.

Starten und aktivieren Sie den Postfix-Dienst:

sudo systemctl enable postfix.service
sudo systemctl start postfix.service

Ändern Sie die Firewall-Regeln für Postfix:

sudo ufw allow Postfix
sudo ufw allow 'Postfix SMTPS'
sudo ufw allow 'Postfix Submission'

Nachdem Sie Postfix installiert haben, müssen Sie Postfix konfigurieren, indem Sie die Hauptkonfigurationsdatei /etc/postfix/main.cfgemäß Ihren tatsächlichen Servereinstellungen bearbeiten .

Hinweis: Zusätzlich zu den obigen Anweisungen müssen Sie ein Support-Ticket senden, um den Standardblock von Vultr an SMTP-Port 25 abzubrechen.

Wenn Sie alternativ eine andere Messaging-Lösung verwenden möchten, überspringen Sie einfach die Installation von Postfix und wählen Sie nach der Installation von GitLab CE die Verwendung eines externen SMTP-Servers.

Schritt 3: Richten Sie das GitLab APT-Repo ein und installieren Sie GitLab CE

Richten Sie das GitLab CE APT-Repository auf Ihrem System ein:

cd
curl -sS https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh | sudo bash

Installieren Sie als Nächstes GitLab CE 11.x:

sudo EXTERNAL_URL="http://gitlab.example.com" apt install -y gitlab-ce

Die Installation kann eine Weile dauern.

Zeigen Sie abschließend auf Ihren bevorzugten Webbrowser http://gitlab.example.comund senden Sie ein neues Kennwort, um die Installation abzuschließen.

Verwenden Sie von nun an die folgenden Anmeldeinformationen, um sich als Administrator anzumelden:

• Nutzername: root
• Passwort: <your-new-password>

Schritt 4: Aktivieren Sie den HTTPS-Zugriff, indem Sie ein Let's Encrypt SSL-Zertifikat integrieren

Derzeit haben Sie GitLab CE 11.x erfolgreich auf Ihrer Serverinstanz installiert, und Benutzer können die Site bereits über das HTTP-Protokoll besuchen. Aus Sicherheitsgründen wird empfohlen, den HTTPS-Zugriff auf Ihren GitLab-Server durch Integration eines Let's Encrypt SSL-Zertifikats zu aktivieren.

Verwenden Sie den viEditor, um die GitLab CE-Konfigurationsdatei zu öffnen:

sudo vi /etc/gitlab/gitlab.rb

Suchen Sie die folgenden zwei Zeilen:

external_url 'http://gitlab.example.com'
# letsencrypt['contact_emails'] = [] # This should be an array of email addresses to add as contacts

Ersetzen Sie sie entsprechend:

external_url 'https://gitlab.example.com'
letsencrypt['contact_emails'] = ['admin@example.com']

Speichern und Beenden:

:wq!

Konfigurieren Sie GitLab CE mit den aktualisierten Einstellungen neu:

sudo gitlab-ctl reconfigure

Die Neukonfiguration kann eine Weile dauern.

Nach Abschluss der Neukonfiguration müssen alle Benutzer beim Zugriff auf die GitLab-Site das HTTPS-Protokoll verwenden.

Hinweis: Nach dem Wechsel von HTTP zu HTTPS können ältere Cookies einen GitLab 422-Fehler verursachen. Das Löschen von Cookies behebt dieses Problem.