Migrieren Ihrer Repositorys von GitLab zu GitHub

Prerequisites

• Sie müssen alle vorherigen Phasen dieses Handbuchs abgeschlossen haben.
• Das GitLab-Projekt muss für Exporte aktiviert sein. Siehe Aktivieren der Projektexport- und Sidekiq-Konfiguration für Importe in der GitLab-Dokumentation.
• Stellen Sie sicher, dass Sie die zu migrierenden Daten und die bekannten Supportbeschränkungen des Importer verstehen. Weitere Informationen finden Sie unter Grundlegendes zu Migrationen von GitLab zu GitHub.
• Es ist zwar nicht erforderlich, die Arbeit während der Produktionsmigration zu unterbrechen, es wird aber empfohlen. Der Importer unterstützt keine Deltamigrationen, sodass Änderungen, die während der Migration vorgenommen werden, nicht migriert werden. Wenn du dich dafür entscheidest, die Arbeit während der Produktionsmigration nicht zu unterbrechen, musst du diese Änderungen manuell migrieren.

Ausführen einer Testversion

Um Probleme aufzudecken, die für Ihr Unternehmen möglicherweise einzigartig sind, empfehlen wir dringend, eine Testausführung Ihrer Migration durchzuführen. Bei einer Testversion lernen Sie Folgendes:

• Gibt an, ob die Migration für ein bestimmtes Repository erfolgreich abgeschlossen werden kann.
• Gibt an, ob Sie das migrierte Repository wieder in einen funktionsfähigen Zustand zurückholen können.
• Wie lange eine Migration dauern wird.

Testläufe können jederzeit ausgeführt werden, und die Arbeit muss während der Migration nicht angehalten werden. Um die Zeit zu verkürzen, die zum Abschließen deiner Testmigration benötigt wird, kannst du die Batches für die Testläufe so planen, dass sie nacheinander ausgeführt werden. Benutzer*innen dieser Repositorys können die Ergebnisse dann selbst überprüfen.

1. Erstelle eine Testorganisation für deine Testmigrationsvorgänge.

   Du kannst eine einzelne Organisation für alle Testläufe verwenden, oder du kannst eine Testorganisation für jede vorgesehene Zielorganisation erstellen. Erwäge, am Ende der Organisationsnamen -sandbox einzufügen, um zu verdeutlichen, dass die Organisationen nur für die Migrationsvalidierung und nicht für die Produktion vorgesehen sind. Du kannst die Testorganisationen löschen, wenn du fertig bist.

2. Führe die Testmigrationsvorgänge aus.

3. Vergewissern Sie sich, dass Sie die Nachverfolgungsaufgaben in Nachverfolgungsaufgaben ausführen können.

4. Bitte die Benutzer*innen, die Ergebnisse der Migrationsvorgänge zu überprüfen.

5. Behebe alle Probleme, die durch die Testmigrationsvorgänge aufgedeckt wurden.

6. Lösche optional die Testorganisation.

Migrieren eines einzelnen Repositorys

Um ein Repository zu migrieren, verwenden Sie den gh gl2gh migrate-repo Befehl.

gh gl2gh migrate-repo \
  --gitlab-server-url GITLAB_SERVER_URL \
  --gitlab-group SOURCE_GROUP \
  --gitlab-project SOURCE_PROJECT \
  --github-org DESTINATION \
  --github-repo NEW_REPO_NAME \
  --use-github-storage

gh gl2gh migrate-repo \
  --gitlab-server-url GITLAB_SERVER_URL \
  --gitlab-group SOURCE_GROUP \
  --gitlab-project SOURCE_PROJECT \
  --github-org DESTINATION \
  --github-repo NEW_REPO_NAME \
  --use-github-storage

Ersetze die Platzhalter im obigen Befehl durch die folgenden Werte.

Wenn Sie dies nicht verwenden GitHub-owned blob storage, lesen Sie Konfigurieren des Blobspeichers.

Zusätzliche Argumente

Generieren eines Migrationsskripts

Wenn Sie mehrere Repositorys GitHub Enterprise Cloud gleichzeitig migrieren möchten, verwenden Sie die GitHub CLI Zum Generieren eines Migrationsskripts. Das resultierende Skript enthält einen migrate-repo Befehl pro Repository.

Führe den Befehl gh gl2gh generate-script aus, um ein Migrationsskript zu generieren.

gh gl2gh generate-script \
  --gitlab-server-url GITLAB_SERVER_URL \
  --github-org DESTINATION \
  --output FILENAME \
  --use-github-storage

gh gl2gh generate-script \
  --gitlab-server-url GITLAB_SERVER_URL \
  --github-org DESTINATION \
  --output FILENAME \
  --use-github-storage

Ersetze die Platzhalter im obigen Befehl durch die folgenden Werte.

Standardmäßig enthält das Skript jedes Projekt, auf das das Token zugreifen kann. Um das Skript zu beschränken, fügen Sie --gitlab-group GROUP``--gitlab-group GROUP --gitlab-project PROJECT es oder für ein einzelnes Projekt hinzu.

Wenn Sie dies nicht verwenden GitHub-owned blob storage, lesen Sie Konfigurieren des Blobspeichers.

Zusätzliche Argumente

Überprüfen des Migrationsskripts

Nachdem du das Skript generiert hast, überprüfst du die Datei, und bearbeitest ggf. das Skript.

• Wenn du einige Repositorys nicht migrieren möchtest, kannst du die entsprechenden Zeilen löschen oder auskommentieren.
• Wenn Repositorys in der Zielorganisation einen anderen Namen erhalten sollen, aktualisiere den Wert für das entsprechende Flag --github-repo.
• Wenn Sie die Sichtbarkeit eines neuen Repositorys ändern möchten, fügen Sie das entsprechende --target-repo-visibility Flag hinzu oder aktualisieren sie.

Migrieren von Repositorys

Wenn die Testausführung erfolgreich war und Sie die Nachverfolgungsaufgaben ausführen konnten, können Sie mit der tatsächlichen Migration fortfahren.

Führen Sie das generierte Skript aus. Ersetze FILENAME in den folgenden Befehlen durch den Dateinamen, den du beim Generieren des Skripts angegeben hast.

• Wenn du ein Terminal verwendest, gibst du ./ ein.

  Shell

  ./FILENAME
  

• Wenn du PowerShell verwendest, gibst du .\ ein.

  Shell

  .\FILENAME