So erstellen Sie Gruppen und verschieben Projekte in GitLab

Erstellen Sie eine Gruppe in GitLab und übertragen Sie anschließend das Projekt über dessen Einstellungen, um Zugriffe und Zusammenarbeit zu organisieren. Wählen Sie die Sichtbarkeit der Gruppe bewusst aus, bestätigen Sie die Übertragung in GitLab und prüfen Sie danach, ob sich das Projekt in der neuen Gruppe befindet.

Eine GitLab-Gruppe erstellen

1. Melden Sie sich an und öffnen Sie in der oberen Navigation Groups. Wählen Sie anschließend Your groups.
2. Wählen Sie New group und dann die Erstellungsoption, die Ihre GitLab-Instanz anbietet.
3. Geben Sie einen Gruppennamen und einen URL-Pfad ein. Der Pfad ist Bestandteil der Gruppen-URL. Wählen Sie daher einen gut erkennbaren, noch verfügbaren Pfad.
4. Legen Sie die Sichtbarkeit danach fest, wer die Gruppe finden oder auf sie zugreifen können soll. Prüfen Sie vor dem Erstellen, welche Sichtbarkeitsoptionen Ihre Instanz anbietet; Organisationsrichtlinien können die Auswahl einschränken.
5. Erstellen Sie die Gruppe. Sie können Mitglieder jetzt oder später einladen und sollten ihnen nur die benötigten Rollen zuweisen. Die Gruppenmitgliedschaft und Projektberechtigungen bestimmen, wer mit dem Projekt arbeiten kann.

Stimmen Sie vor dem Erstellen den Namen und den URL-Pfad mit den Personen ab, die die Gruppe verwenden werden. Der Pfad ist Teil der Adresse, die Teammitglieder weitergeben. Wenn Sie die Gruppenerstellung automatisieren möchten, konsultieren Sie die GitLab-Dokumentation zur Groups API für Ihre GitLab-Version. Prüfen Sie dort, ob der Vorgang unterstützt wird und welche Pflichtfelder, Authentifizierung und Berechtigungen erforderlich sind. Diese Anleitung enthält keine Anfrage zur Gruppenerstellung über die API und bestätigt auch keine solche Anfrage.

Ein vorhandenes GitLab-Projekt in eine Gruppe übertragen

1. Öffnen Sie das Projekt und wechseln Sie zu Settings > General.
2. Klappen Sie Advanced auf oder scrollen Sie dorthin und suchen Sie nach Transfer project. Die genauen Bezeichnungen können je nach GitLab-Version und Berechtigungen abweichen.
3. Wählen Sie die Zielgruppe aus. Vergewissern Sie sich, dass es der gewünschte Namensraum ist, da sich die Projekt-URL nach Abschluss der Übertragung ändert.
4. Folgen Sie der Bestätigungsaufforderung von GitLab. Möglicherweise müssen Sie den Projektnamen eingeben. Senden Sie anschließend die Übertragung ab.
5. Öffnen Sie das Projekt über die Zielgruppe und prüfen Sie die neue URL und den Namensraum. Fehlt die Übertragungsoption oder ist das Ziel nicht verfügbar, bitten Sie einen Gruppenbesitzer oder Instanzadministrator, Ihre Rolle und die Übertragungsrichtlinien zu prüfen.

Wenn Sie die Übertragung automatisieren möchten, prüfen Sie in der GitLab-Dokumentation zur Projects API für Ihre GitLab-Version den Endpunkt für die Projektübertragung, die HTTP-Methode, die Nutzlast sowie die Anforderungen an Authentifizierung und Berechtigungen, bevor Sie eine Anfrage senden. Die Dokumentation ist maßgeblich für den Aufbau der Anfrage. Das folgende Python-Beispiel stellt lediglich beispielhafte Anfragedaten zusammen und gibt sie aus. Die Beispiel-IDs und die Nutzlast sind keine versionsübergreifend gültigen Vorgaben. Das Beispiel kontaktiert GitLab nicht und prüft nicht, ob eine Anfrage angenommen wird:

import json

project_id = 456
group_id = 123
request = {
    "method": "POST",
    "path": f"/api/v4/projects/{project_id}/transfer",
    "json": {"namespace_id": group_id},
}
print(json.dumps(request, sort_keys=True))

{"json": {"namespace_id": 123}, "method": "POST", "path": "/api/v4/projects/456/transfer"}

Nachdem GitLab die Übertragung bestätigt hat, öffnen Sie das Projekt erneut über die Zielgruppe und prüfen Sie, ob Namensraum und URL den neuen Speicherort widerspiegeln. Kontrollieren Sie anhand der Sichtbarkeits- und Mitgliedschaftseinstellungen der Zielgruppe, wer auf das Projekt zugreifen kann, und stellen Sie sicher, dass die vorgesehenen Mitwirkenden es erreichen können. Wenn Sie mehrere Projekte verschieben, führen Sie jede Übertragung gemäß den Anweisungen für die Benutzeroberfläche oder API Ihrer GitLab-Version durch. Gehen Sie nicht davon aus, dass eine Sammelübertragung verfügbar ist. Prüfen Sie im Rahmen der teaminternen Umzugscheckliste außerdem den Projektverlauf, Integrationen und Zugriffsrechte.