Inhaltsverzeichnis
Installationsanleitung
| Version | Status | Datum | Autor | URL |
|---|---|---|---|---|
| 0.1 | Entwurf | 08.10.2021 | Koch Joel | |
| 0.2 | Ergänzungen | 18.10.2021 | Koch Joel | |
| 1.0 | Review und Freigabe | TT.MM.JJJJ | Vorname Nachname |
1. Kurzfassung
In dieser Anleitung wird beschrieben, wie man auf einen Ubuntu Server, GitLab installiert. Die Installation des Servers erfolgt über die Kommandozeile. In meinem Fall habe ich auf dem DNS-Server zuerst noch ein Host-Eintrag erstellt, damit ich den Server direkt auf die Domain installieren kann. Bei GitLab ist es sehr wichtig dass die URL von Anfang an stimmt, sonst kann es zu Komplikationen geben.
2. Installation
2.1 Notwendige Pakete
Zuerst installieren wir folgende Pakete, die man für die Installation von GitLab braucht.
sudo apt-get update sudo apt-get install -y curl openssh-server ca-certificates tzdata perl
2.2 GitLab
Zuerst fügen wir das GitLab Paket Repository hinzu.
curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash
Danach installieren wir das GitLab Package, wie schon erwähnt, sollte die URL von Anfang an stimmen. Also zuerst schauen ob der DNS richtig konfiguriert ist und ob man http oder https benutzen will.
sudo EXTERNAL_URL="https://gitlab.example.com" apt-get install gitlab-ee
Nun geht man zu dem Hostname in dem Browser seiner Wahl. Beispiel: gitlab.safe.org
Dann geht man auf dem Server in die untenstehende Datei, da dort das generierte root Passwort ist.
/etc/gitlab/initial_root_password
Damit kann man sich nun einloggen und schon ist der GitLab Server aufgesetzt.
3. LDAP
3.1 Konfiguration
Um die LDAP-Authentifizierung zu konfigurieren, gehen wir in dieses File:
sudo su nano /etc/gitlab/gitlab.rb
In diesem File geht man zu der Linie 450, das kann man einfach mit CTRL + _ machen. Dort verändert man die Zeilen mit seinen Credentials, damit es danach ungefähr so aussieht.
Wenn man dies erledigt hat, kann man mal die LDAP Verbindung mit diesem Befehl testen, falls alles gut ist, kann man gerade noch gitlab rekonfigurieren.
gitlab-rake gitlab:ldap:check gitlab-ctl reconfigure
Danach kann man nocheinmal diesen Befehl ausführen, damit man sehen kann ob alle User erkennt werden.
gitlab-rake gitlab:ldap:check
Nun gibt es beim Anmelde-Screen noch ein neuen Tab mit LDAP. Bei diesem kann man sich nun mit den LDAP-Usern anmelden.
5. Testing
GitLab-Installation
| Testfall Nr. | #1 |
|---|---|
| Beschreibung | Das Verbinden mit dem GitLab Server |
| Vorgehen | Den Internetbrowser seiner Wahl öffnen |
| Dann zu Beispiel: gitlab.safe.org gehen | |
| Voraussetzung / Umfeld | Die GitLab installation wurde richtig durchgeführt |
| Erwartetes Resultat | Die Verbindung wird ohne Probleme hergestellt. |
| OK / nicht OK | OK |
| Aufgetretene Fehler / Bemerkungen | Keine |
LDAP-Verbindung
| Testfall Nr. | #2 |
|---|---|
| Beschreibung | Das Anmelden via LDAP funktioniert |
| Vorgehen | Mit den Benutzerdaten von einem LDAP Benutzer sich im GitLab einloggen |
| Voraussetzung / Umfeld | Die LDAP Verbindung ist richtig konfiguriert. |
| Erwartetes Resultat | Man kann sich einloggen |
| OK / nicht OK | OK |
| Aufgetretene Fehler / Bemerkungen | Keine |
6. Auswertung
Diese Installation war obwohl sie bei mir beim ersten mal geklappt hat, sehr informativ und spannend.
7. Quellenverzeichnis
https://about.gitlab.com/install/#ubuntu
https://www.youtube.com/watch?v=M8wk0Kh8yJU