Phase 5. Migrieren Ihrer Repositorys von Azure DevOps zu Github

Voraussetzungen

Sie müssen alle vorherigen Phasen dieses Handbuchs abgeschlossen haben.
Stellen Sie sicher, dass Sie die zu migrierenden Daten und die bekannten Supportbeschränkungen des Importer verstehen. Weitere Informationen finden Sie unter Phase 1. Grundlegendes zu Migrationen von Azure DevOps 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.

Generieren eines Migrationsskripts

Der Migrationsskriptgenerator der Unternehmens-Migrationstools verwenden

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

Shell

gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME

gh ado2gh generate-script --ado-org SOURCE --github-org DESTINATION --output FILENAME

Ersetze die Platzhalter im obigen Befehl durch die folgenden Werte.

Platzhalter	Wert
SOURCE	Name der Ursprungsorganisation
DESTINATION	Name der Zielorganisation
FILENAME	Ein Dateiname für das resultierende Migrationsskript Wenn du das Terminal verwendest, legst du als Erweiterung `.ps1` fest, da für das generierte Skript PowerShell ausgeführt werden muss. Du kannst PowerShell für Mac oder Linux installieren.

Zusätzliche Argumente

Argument	Description
`--target-api-url TARGET-API-URL`	Wenn du zu GHE.com migrierst, füge `--target-api-url TARGET-API-URL` hinzu, wobei TARGET-API-URL die Basis-API-URL für die Unterdomäne deines Unternehmens ist. Beispiel: `https://api.octocorp.ghe.com`
`--all`	Fügen Sie dem Skript zusätzliche Funktionen hinzu, z. B. das Umleiten von Pipelines, das Erstellen von Teams und das Konfigurieren von Azure Boards-Integrationen.
`--download-migration-logs`	Überprüfen Sie das Migrationsprotokoll für jedes migrierte Repository. Weitere Informationen zu Migrationsprotokollen findest du unter Zugriff auf die Migrationsprotokolle von GitHub Enterprise Importer.

Überprüfen des Migrationsskripts

Bewerten Sie das Migrationsskript im Enterprise-Migrationstool.

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.

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.
Führe die Testmigrationsvorgänge aus.
Vergewissern Sie sich, dass Sie die Nachverfolgungsaufgaben in Phase 6. Nachverfolgungsaufgaben ausführen können.
Bitte die Benutzer*innen, die Ergebnisse der Migrationsvorgänge zu überprüfen.
Behebe alle Probleme, die durch die Testmigrationsvorgänge aufgedeckt wurden.
Lösche optional die Testorganisation.

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.

Warnung

Es wird empfohlen, die Arbeit in den Repositories, die Sie migrieren, zu stoppen. Alle Änderungen, die während oder nach der Migration vorgenommen wurden, müssen manuell migriert werden.

Nächste Schritte

In der nächsten und letzten Phase führen Sie Nachverfolgungsaufgaben durch, überprüfen Protokolle und bereiten Ihre Repositorys zur Verwendung bereit. Weitere Informationen findest du unter Phase 6. Nachverfolgungsaufgaben.