Erste Schritte mit git.nrw
Auf dieser Seite
Der Login für git.nrw erfolgt über das Single Sign-On System der jeweiligen Hochschule.
Projekt anlegen
Ein neues Projekt kann über das „+" Symbol oder den Button „New Project" angelegt werden. Hierbei sind folgende Angaben wichtig:
- Project Name — Name des Projektes z.B. „Mein-Test-Projekt". Der Name darf keine Leerzeichen und Sonderzeichen enthalten.
- Visibility Level (Sichtbarkeit)
- Private (Nur Sie selbst können das Projekt sehen)
- Intern (Alle Nutzenden der git.nrw Instanz können das Projekt sehen)
- Public (Das Projekt ist weltweit einsehbar)
Mit einem Klick auf „Create Project" wird das Projekt angelegt.
Das Projekt kann optional mit einer README-Datei initialisiert werden. Ebenso lassen sich nach der Erstellung des Projekts weitere Einstellungen vornehmen, z.B. Mitglieder hinzufügen, CI/CD Pipelines konfigurieren usw.
Um später Schreibzugriff auf Projekte zu haben, müssen Sie ein Benutzer-Kennwort festlegen. Dazu gehen Sie in „User Settings" oben links und im folgenden Bereich links auf „Password". Das Benutzerpasswort ist nicht identisch mit dem Passwort des Single Sign-On, das Passwort wird individuell festgelegt.
Runner
Unter docs.gitlab.com/runner finden Sie Anleitungen, wie Sie den GitLab Runner auf verschiedenen Betriebssystemen installieren können.
Projekt-Export
Beim Exportieren von Projekten werden folgende Elemente exportiert:
- Projekt- und Wiki-Repositorys
- Projekt-Uploads
- Projektkonfiguration, einschließlich Diensten
- Issues mit Kommentaren, Merge Requests mit Diffs und Kommentaren, Labels, Milestones, Snippets und anderen Projektteilen
- LFS-Objekte
- Issue Boards
Folgende Elemente werden nicht exportiert:
Export über die GUI
- Projektseite aufrufen
- In der linken Navigationsleiste auf “Settings” und „General" klicken
- Runter Scrollen bis zum Punkt “Advanced”
- Dort den Bereich “Export project” suchen und den Button “Export project” drücken
Sobald der Export abgeschlossen ist, erscheint neben dem “Export project” Button ein “Download export” Button. Diesen bitte anklicken. Nachdem der Export heruntergeladen wurde, kann dieser wieder in GitLab importiert werden.
Projekt-Import
Handelt es sich bei dem Projekt um ein Gruppen-Projekt, muss vor dem Import erst die entsprechende Gruppe erstellt werden!
Import über die GUI
Für den Import während des Erzeugens eines neuen Projekts auf “Import Project” klicken und dort auf “GitLab Export” klicken. Im nun folgenden Schritt „Project name", „project URL" und „Project slug" setzen.
Bei “Choose File” wird nun der GitLab Export ausgewählt. Danach kann das Visibility Level ausgewählt und optional eine Beschreibung angegeben werden. Anschließend wird durch den Button „Create project" der Import abgeschlossen.
Bei der Migration werden Berechtigungen nicht übernommen und vorhandene, lokale Kopien des Projekts müssen aktualisiert werden.
Eine Gruppe erstellen
Zunächst muss die Gruppenübersicht aufgerufen werden, hierzu im oberen Menü zunächst „Groups", dann „Your Groups" anklicken. Anschließend kann die Gruppe über den Button „New Group" erstellt werden. Folgende Einstellungen müssen getroffen werden:
- Unter “Group name” einen Gruppennamen vergeben
- Die “Group URL” wird automatisch nach dem Projektnamen ausgefüllt
- Die “Group description” kann mit einer Beschreibung der Gruppe gefüllt werden
- Unter “Group avatar” kann ein Gruppenbild festgelegt werden
- Unter “Visibility level” wird das Sichtbarkeits-Level der Gruppe festgelegt (private, internal, public)
Mit einem Klick auf “Create group” wird die Gruppe angelegt und Mitglieder können hinzugefügt werden. Dazu im Gruppenmenü auf „Members" klicken und die entsprechenden E-Mail-Adressen oder Benutzernamen eingeben. In dieser Ansicht können Mitglieder auch entfernt oder die Gruppe vom/von der Ersteller/in verlassen werden.
Mitglieder können auch zu Projekten hinzugefügt werden, ohne dass eine Gruppe hierfür erstellt wird. Dies schränkt jedoch die Kontrolle und Rollen innerhalb des Projektes ein.