Logo

Gruppen und Projekte zu git.nrw migrieren

Zuletzt aktualisiert: 19.02.2026 2 Min. Auf GitLab bearbeiten
Auf dieser Seite
Zusammenfassung

Sie können Ihre Gruppen einschließlich Mitglieder und Projekte von Ihrer GitLab-Instanz zu git.nrw migrieren. Kurzübersicht:

  1. Beachten Sie, dass in git.nrw Quota-Limits gelten.
  2. Stellen Sie sicher, dass sich jedes Gruppenmitglied mindestens einmal bei git.nrw angemeldet hat, bevor die Migration durchgeführt wird.
  3. Stellen Sie sicher, dass jedes Gruppenmitglied seine E-Mail-Adresse im Quell-GitLab auf öffentlich gesetzt hat (kann temporär sein) und in beiden Systemen dieselbe primäre E-Mail-Adresse verwendet*.
  4. Erstellen Sie einen persönlichen Zugriffstoken im Quell-GitLab.
  5. Erstellen Sie eine Gruppe in git.nrw und verwenden Sie die Funktion „Import group", um Ihre Quell-GitLab-Instanz zu verbinden.
  6. Migrieren Sie die gewünschten Gruppen.

*Andernfalls werden bei der Migration „Platzhalter"-Benutzer erstellt, die Sie anschließend manuell zuordnen müssen.

Eine detaillierte Anleitung finden Sie unten.

Schritt 1: Voraussetzungen

Diese Anleitung beschreibt einen Weg, Ihre GitLab-Gruppen und -Projekte über die Direct-Transfer-Funktion zu git.nrw zu migrieren. Direct Transfer kann Ihre Gruppenmitglieder und Repository-Daten direkt zu git.nrw übertragen. Informieren Sie sich darüber, was migriert wird und über die geschätzte Migrationsdauer . Beachten Sie, dass Ihr GitLab-Administrator möglicherweise einige GitLab-Einstellungen anpassen muss, um die Migration zu ermöglichen: Voraussetzungen für GitLab-Administratoren .

Voraussetzungen (Gruppenbesitzer)

  1. Benutzerkonto-Einrichtung
    • Alle Gruppenmitglieder müssen sich mindestens einmal bei git.nrw angemeldet haben, bevor die Übertragung erfolgt.
    • E-Mail-Adressen müssen übereinstimmen und im Quell-GitLab bestätigt und öffentlich sein.
    • Benutzerprofil überprüfen unter: GitLab-Profileinstellungen .
      Öffentliche E-Mail-Einstellungen
Warnung

Gruppenmitglieder werden nicht migriert, wenn sie sich vor der Migration nicht bei git.nrw angemeldet und eine öffentliche E-Mail-Adresse auf der Quell-GitLab-Instanz eingestellt haben. Die Commit-Historie kann Einträge auch nur dann dem git.nrw-Benutzerkonto zuordnen, wenn alle E-Mail-Adressen des Quell-GitLab-Benutzerkontos zum git.nrw-Benutzer hinzugefügt werden. Wenn Sie fehlende E-Mail-Adressen jedoch nachträglich hinzufügen, kann git.nrw Commits auch nach abgeschlossener Migration dem Benutzerkonto zuordnen.

Schritt 2: Übertragungsprozess

1. Zugriffstoken erstellen

  • Erstellen Sie einen Zugriffstoken für Ihren Benutzer in Ihrer GitLab-Instanz (nicht git.nrw).
  • Der Token benötigt mindestens die Scopes api und read_repository

2. Übertragung starten

  • Erstellen Sie eine neue Gruppe auf gitlab.git.nrw: https://gitlab.git.nrw/groups/new
  • Wählen Sie Import group:
    Gruppe importieren
  • Geben Sie Ihre GitLab-URL (1) und Ihren Zugriffstoken (2) ein und klicken Sie auf connect instance (3):
    Direct Transfer
  • Wählen Sie die zu importierende Quellgruppe (1), eine Übergeordnete Gruppe auf git.nrw (2) und einen Gruppennamen (3) und klicken Sie auf Import with projects (4) (alternativ können Sie „import without projects" wählen):
    Gruppen auswählen
  • Anschließend können Sie den Fortschritt der Migration verfolgen. Dies kann je nach Anzahl der zu migrierenden Projekte einige Zeit dauern. Sie werden per E-Mail benachrichtigt, wenn die Migration abgeschlossen ist. Mitglieder erhalten ebenfalls eine E-Mail über den Zugang zur neuen Gruppe auf gitlab.git.nrw.
  • Weitere Informationen finden Sie in der offiziellen GitLab-Übertragungsanleitung: