Debian 8
Getestet wurde die Installationsanleitung unter Debian 8. Dort wurden folgende Varianten verwendet:su - apt-get install curl openssh-server ca-certificates postfix wget https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh chmod 775 script.deb.sh ./script.deb.sh apt-get install gitlab-ce gitlab-ctl reconfigure
Das Paket postfix ist insbesondere bei Debian wichtig, weil dort standardmäßig Exim4 installiert ist, mit dem GitLab nicht wirklich gut zusammenarbeitet.
Das Paket git oder git-core wurde bisher nicht installiert. Ich habe dies getan, bin aber nicht sicher, ob das erforderlich ist.
Der GitLab-Server braucht nach Vorgabe 2 GB RAM. Tatsächlich wird der Server sehr träge, wenn er nur wenig Speicher hat.
Linux Mint 20
Das Verfahren funktionierte bei Linux Mint 20 im Dezember 2021 nicht ganz so. Das Paket gitlab-ce wurde als nicht existent gemeldet.Das Paket wurde nun von Hand von der folgenden URL geladen:
https://packages.gitlab.com/gitlab/gitlab-ce.
Wichtig ist, dass die Architektur (amd für PCs und arm für RISC-Prozessoren) stimmt. Das Paket ist immerhin über 900 MB groß. Eine schnelle Internetleitung ist hilfreich.
gdebi gitlab-ce_14.6.0-ce.0_amd64.deb gitlab-ctl reconfigureAnschließend wird diese Datei mit dem folgenden Befehl installiert.
Erste Kontaktaufnahme
Nun wird der Git-Server über seine IP-Adresse aufgerufen. Beim ersten Mal wird das neue Passwort für die Git-Administration erfragt. Es muss mindestens acht Buchstaben lang sein.Im nächsten Schirm wird nach "Username or email" und dem Passwort gefragt. Der Login erfolgt mit dem Benutzer root und dem eben vergebenen Passwort.
Nun kann ein Projekt angelegt werden (maximal 10?) oder eine Gruppe, die zur Verwaltung von Projekten und Anwendern dient.
Beim Test mit Linux Mint 20 erschien keine Möglichkeit das Passwort interaktiv einzugeben. Dort wurde ein vorläufiges Passwort in der Datei /etc/gitlab/initial_root_password abgelegt. Dieses wurde beim ersten Anmelden des Users root eingegeen. Im Kommentar der Datei steht, dass es nach 24 Stunden gelöscht wird.
Unter Edit Profile wird das Passwort eingestellt.
Das Passwort muss schnellstens geändert werden, da das vorläufige Passwort bald verfällt.
Anlegen eines Projekts
Der Projektpfad besteht aus der IP-Adresse des Servers, des Benutzers und des Projektnamens, der hier angegeben wird. Hinzu kommt eine optionale Beschreibung des Projekts. Schließlich wird die Sichtbarket des Projekts angegeben.
- Private: Das Projekt muss jedem Benutzer gegenüber freigegeben werden.
- Internal: Das Projekt darf von jedem angemeldeten Benutzer geclonet werden.
- Public: Das Projekt darf ohne Authentifizierung geclonet werden.
Public
Das Projekt wird angelegt. Auf dem Folgebildschirm wird die HTTP-URL angezeigt, es kann auch auf die SSH-URL umgeschaltet werden. Bei der URL wird der Hostname des Rechner, der Anleger des Projekts und der Name des Projekts aneinander gehängt.Ein Clone erfolgt folgendermaßen:
git clone http://172.16.91.128/root/testpublicprojekt.gitIm aktuellen Verzeichnis entsteht ein Verzeichnis testpublicprojekt.
Push und Pull ist nur über einen SSH-Key möglich.
Anlegen eines Benutzers
Über den Schraubenschlüssel kann die Administrations-Bildschirm erreicht werden. Dort kann ein neues Projekt, ein neuer Benutzer und eine neue Gruppe angelegt werden. Wir legen einen Benutzer an.
- Name: Projekt Paul
- Username propaul
- Email: propaul@irgendwas.de
Die Zugriffsrechte können eingestellt werden.
- Die Anzahl der Projekte ist auf 10 voreingestellt, kann hier aber verändert werden.
- Kann Gruupen anlegen
- Admin
- External: kann weder interne noch private Projekte sehen.