3. Starten der Migration

1. Melden Sie sich bei der Azure CLI an:

   az login
   

2. Legen Sie Ihre standardmäßige Azure DevOps Organisation fest:

   az devops configure --defaults organization=https://dev.azure.com/myorg
   

   Tipp

   Wenn Ihr lokales Git-Remote auf eine andere Organisation verweist, fügen Sie allen Migrationsbefehlen --detect false hinzu, um zu verhindern, dass die automatische Erkennung die falsche Organisation auswählt.

3. Überprüfen Sie Ihren Zugriff:

   az devops project list
   

4. Rufen Sie die Repository-GUID ab:

   az repos show --org https://dev.azure.com/<org>
                 --project <project>
                 --repository <repo-name>
                 --query id
                 -o tsv
   

1. Melden Sie sich bei Ihrer Azure DevOps Organisation bei https://dev.azure.com/<org>.
2. Öffnen Sie das Ziel-project, und wählen Sie dann Project Einstellungen aus.
3. Wählen Sie Repositorys aus, und bestätigen Sie, dass das Repository vorhanden ist, das Sie migrieren möchten.
4. Lassen Sie das Portal geöffnet, damit Sie den Agentstatus später unter Project Einstellungen>Agent-Pools überprüfen können.

Beginnen Sie mit diesem Basisbefehl für jede Migration:

az devops migrations create --org https://dev.azure.com/<org>
                            --repository-id <repo-guid>
                            --target-repository https://github.com/<org>/<repo>
                            --github-token <github-pat>
                            --service-endpoint-id <service-connection-guid>
                            --agent-pool <agent-pool-name>

In --target-repository ist <repo> der GitHub Repositoryname. Wählen Sie einen beliebigen verfügbaren Namen aus. Es muss nicht mit dem Azure DevOps Repositorynamen übereinstimmen.

Fügen Sie optionale Parameter basierend auf Ihrem Migrationsszenario hinzu:

Migrationsstatus überprüfen:

az devops migrations status --org https://dev.azure.com/<org>
                            --repository-id <repo-guid>

Suchen nach:

• status - aktueller Migrationsstatus (Active, Succeeded, Completed, Failed, Suspended)
• stage- aktuelle Migrationsphase (Queued, Validation, Synchronization, CutoverReviewForCutover, , ReadyForCutover) Migrated
• validationIssues - Liste der Vorprüfungsfehler mit Fehlercodes und Meldungen
• errorMessage - Details zum Fehler

1. Öffnen Sie in Ihrem project Project Einstellungen.
2. Wählen Sie unter Repos "Migration zum GitHub" aus.
3. Wählen Sie " Neue Migration starten" aus.
4. Wählen Sie ein oder mehrere Repositorys aus, die migriert werden sollen, und wählen Sie dann "Weiter" aus.
5. Geben Sie auf der Seite mit den Migrationsdetails die folgenden Werte an:
   • Migrationsaktion: Wählen Sie entweder Ausgewählte Repositorys nach der Validierung migrieren oder Validierung ausführen und später migrieren.
   • Ziel-Repository: Geben Sie die GitHub Repository-URL im Format https://<enterpriseUrl>/<orgname>/<repo>ein.
   • GitHub-Token: Fügen Sie Ihr GitHub persönliches Zugriffstoken ein.
   • Anpassen der Ziel-Repositorynamen für alle ausgewählten Repositorys (optional): Fügen Sie ein Präfix und/oder Suffix hinzu. Verwenden Sie keine Leerzeichen in Repositorynamen.
   • Dienstverbindung: Wählen Sie die in den Voraussetzungen erstellte GitHub Dienstverbindung aus.
   • Agentpool: Wählen Sie den selbst gehosteten Linux-Agentpool aus, in dem Ihr Migrations-Agent ausgeführt wird.
   • Erstellen Sie eine Boards-Verbindung (optional): Wählen Sie aus, ob ELM eine Boards-Verbindung erstellen soll.
   • Pipelines automatisch erkennen und neu verbinden (optional): Wählen Sie diese Option aus, um die Neuverbindung von Pipelines zu verwenden.
   • Pipelinedienstverbindung (optional): Wählen Sie die in den Voraussetzungen erstellte Pipelinedienstverbindung aus.
6. Wählen Sie "Überprüfung ausführen" oder " Migration starten" basierend auf der von Ihnen ausgewählten Migrationsaktion aus.
7. Öffnen Sie die Migrationsdetails, und bestätigen Sie, dass die Überprüfung ausgeführt wird.

1. Starten Sie die Synchronisierung innerhalb von 24 Stunden, nachdem die Überprüfung erfolgreich war:

   az devops migrations resume --org https://dev.azure.com/<org>
                               --repository-id <repo-guid>
                               --migration
   

2. Status erneut überprüfen:

   az devops migrations status --org https://dev.azure.com/<org>
                               --repository-id <repo-guid>
   

1. Wechseln Sie in Ihrem Azure DevOps-Projekt zu Projekteinstellungen>Repos>Migration nach GitHub.
2. Öffnen Sie die Migration, die die Überprüfung erfolgreich abgeschlossen hat.
3. Wählen Sie "Synchronisierung starten" aus, um die Überprüfung zur vollständigen Synchronisierung zu fördern.
4. Vergewissern Sie sich, dass sich der Migrationsstatus in der Synchronisierungsphase ändert.

1. Suchen Sie die Pipelinedefinitions-IDs, die auf das migrierende Repository verweisen.

   az devops migrations pipelines list zeigt nur die Pipelines an, die bereits für die Neuverkabelung registriert sind, sowie deren Status der Neuverkabelung. Bevor Sie Pipelines übermitteln, wird ein leeres Ergebnis zurückgegeben, sodass Sie es nicht zum Ermitteln von Kandidatenpipelines verwenden können. Um die neu zuzuordnenden Definitions-IDs zu finden, führen Sie die Pipelines auf, die aus dem Quellrepository erstellt werden:

   az pipelines list --org $org \
                     --project $project \
                     --repository $rid \
                     --repository-type tfsgit \
                     --query "[].{id:id, name:name}" -o table
   

   Verwenden Sie die id Werte aus der Ausgabe als --pipeline-ids im nächsten Schritt.

   Note

   az pipelines list --repository gibt nur Pipelines zurück, deren Standardtrigger-Repository das Quell-Repository ist. Eine Pipeline, die über einen Ressourcen-, Vorlagen- oder Checkoutschritt auf das Repository verweist (anstatt es als ihr primäres Repository zu verwenden), wird hier möglicherweise nicht angezeigt. Fügen Sie diese Definitions-IDs ebenfalls ein, wenn Sie wissen, dass sie vom Migrieren des Repositorys abhängen.

2. Senden Sie ausgewählte Pipelinedefinitions-IDs für die Umleitung (maximal 200 IDs pro Anforderung):

   az devops migrations pipelines submit --org $org \
                                        --repository-id $rid \
                                        --pipeline-ids 42 43 44 \
                                        --service-connection-id $scid
   

   --service-connection-id ist optional, wenn Sie bereits über --pipeline-service-connection-id in migrations create oder in einem vorherigen pipelines update --service-connection-id eine Verbindung hinzugefügt haben.

3. Wenn eine Pipeline auf andere Repositorys verweist, ordnen Sie jedes Quellrepository dem GitHub Ziel zu:

   az devops migrations pipelines submit --org $org \
                                        --repository-id $rid \
                                        --pipeline-ids 42 43 44 \
                                        --service-connection-id $scid \
                                        --repository-mapping aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa=<GH_ORG>/shared-templates \
                                        --repository-mapping bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb=<GH_ORG>/another-repo
   

   Format: --repository-mapping <sourceRepoId>=<targetOwner>/<targetRepo> (wiederholbar).

4. Überwachen und Anpassen des Pipeline-Satzes:

   az devops migrations pipelines list --org $org --repository-id $rid -o table
   

   Nachdem Sie Pipelines eingereicht haben, listet dieser Befehl alle angemeldeten Pipelines und ihren Status der Neuverkabelung auf:

   Column	Bedeutung
   DefinitionId	Definitions-ID der Pipeline
   Name	Pipelinename (fällt auf den YAML-Dateinamen zurück, wenn der Name noch nicht verfügbar ist)
   Classification	Wie die Pipeline auf das Repository verweist
   Status	Aktueller Umverdrahtungsstatus der Pipeline
   ErrorMessage	Fehlerdetails, wenn sich die Pipeline in einem fehlerhaften Zustand befindet

   az devops migrations pipelines update --org $org \
                                        --repository-id $rid \
                                        --add-ids 50 51 \
                                        --remove-ids 42 \
                                        --retry-ids 43 \
                                        --service-connection-id $scid
   

   • --add-ids: Fügen Sie weitere Pipelines hinzu.
   • --remove-ids: Pipelines aus der Neuverkabelung entfernen.
   • --retry-ids: Versuchen Sie Pipelines im Zustand Failed erneut.
   • Mindestens einer von --add-ids, --remove-ids, --retry-ids, --service-connection-id oder --repository-mapping ist erforderlich.

   Tastenkombination nur für Wiederholung:

   az devops migrations pipelines retry --org $org --repository-id $rid --pipeline-ids 43
   

5. Beim Cutover überprüfen und genehmigen, wenn die Phase ReviewForCutover ist:

   az devops migrations cutover review --org $org --repository-id $rid -o table
   

   Überprüfen Sie wichtige Felder:

   Feld	Bedeutung
   FailedCount / BlockedCount / PendingCount / TotalUnprocessedCount	Anzahl der nicht verarbeiteten Elemente (fehlgeschlagen, blockiert, ausstehend und summe)
   RequiresPipelineVerification (requiresPipelineVerificationAcknowledgment)	Wenn true, muss die Genehmigung --pipelines-verified enthalten
   State / Type / PullRequestUrl (von failedItems[])	Details zu Fehlern pro Element

6. Cutover genehmigen:

   az devops migrations cutover approve --org $org \
                                       --repository-id $rid \
                                       --pipelines-verified
   

   Wenn Sie auch nicht verarbeitete Elemente akzeptieren:

   az devops migrations cutover approve --org $org \
                                       --repository-id $rid \
                                       --accept-failures 3 \
                                       --pipelines-verified
   

   Sie müssen mindestens eines von --accept-failures oder --pipelines-verified angeben.

1. Öffnen Sie im Migrationsdashboard das Menü für das migrierende Repository, und wählen Sie "Rewire-Pipelines" aus.
2. Wählen Sie "Rewire " auf den Pipelines aus, die Sie verbinden möchten.
3. Ein blauer Statusindikator zeigt neu verdrahtete Pipelines an.