4. Überwachen der Migration

Azure DevOps Services

Die anfängliche Synchronisierung kann je nach Größe Ihres Repositorys mehrere Stunden oder sogar Tage dauern. Nach Abschluss der ersten Synchronisierung führt ELM weiterhin regelmäßige Synchronisierungen für bis zu 21 Tage aus, um laufende Updates zu erfassen. Während dieses 21-Tage-Zeitraums müssen Sie den Cutover durchführen, um die Migration abzuschließen.

Um zu sehen, welche Repositories sich in jeder Phase befinden, führen Sie az devops migrations list aus und filtern Sie nach dem Feld stage. Fehler werden in der Ausgabe des Migrationsstatus angezeigt, damit Sie Probleme identifizieren und beheben können, bevor Sie fortfahren.

Important

Parallelitätsgrenzwert: Jedes Unternehmen kann bis zu 30 aktive Migrationen gleichzeitig ausführen, einschließlich maximal 20 anfänglicher Migrationen. Um Kapazität für eine andere Migration freizustellen, schließen Sie den Übernahmevorgang für eine vorhandene Migration ab.

Nachverfolgen des Migrationsstatus

Alle Migrationen für Ihre Organisation auflisten:

az devops migrations list --org https://dev.azure.com/<org>

Migrationsphasen

Stage Description
In der Warteschlange Migration angenommen; die Arbeit hat noch nicht begonnen.
Validation Ausführen von Überprüfungen vor der Migration.
Synchronization Kopieren und Synchronisieren von Repositoryinhalten.
Umstellung Ausführen der endgültigen Synchronisierung und Übergang zu GitHub.
Überprüfung für die Umstellung Die Umstellung hat den geplanten Zeitpunkt mit ungelösten Fehlern erreicht und wartet auf cutover approve (oder eine Neuplanung).
ReadyForCutover Genehmigt und wartet auf den nächsten ELM-Auftrag, um die endgültige Umschaltung durchzuführen.
Migriert Die Migration ist abgeschlossen. GitHub ist das System of Record.

Migrationsstatus

Status Bedeutung
Aktiv Die Migration wird ausgeführt.
Erfolgt Die aktuelle Phase wurde erfolgreich abgeschlossen.
Abgeschlossen Die Migration hat die Endphase Migrated erreicht.
gescheitert Ein Fehler ist aufgetreten. Sie können den Vorgang fortsetzen, nachdem Sie das Problem behoben haben.
Gesperrt Manuell pausiert. Sie können den Vorgang fortsetzen.

Was zu beobachten ist

  • Letzte erfolgreiche Synchronisierungszeit – bestätigen Sie, dass die Synchronisierungen im Zeitplan ausgeführt werden.
  • Synchronisierungsstatus – identifizieren Sie, ob die Migration voranschreitet oder angehalten ist.
  • Fehlerzustände — ELM versucht bei temporären Fehlern automatisch erneut. Für persistente Fehler ist eine Untersuchung erforderlich.

Fortsetzen nach einem Synchronisierungsfehler

Wenn Synchronisierungsfehler auftreten, untersuchen Sie die Fehlerdetails, und beheben Sie das zugrunde liegende Problem. Lassen Sie dann ELM automatisch fortsetzen oder eine der folgenden Methoden verwenden.

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

Anhalten und Fortsetzen der Migration

Wenn Sie eine Migration vorübergehend beenden und im selben Modus neu starten müssen:

Führen Sie Folgendes aus, um die Migration anzuhalten:

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

Führen Sie Folgendes aus, um die Migration fortzusetzen:

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

Hinweis

Sie können eine Migration für eine beliebige Dauer anhalten, aber das 21-Tage-Übernahmefenster gilt weiterhin.

Abbrechen der Migration

An jedem Punkt während der Synchronisierung können Sie eine Migration beenden und löschen. Diese Aktion löscht den Migrationsdatensatz endgültig.

Führen Sie den folgenden Befehl aus: Sie werden aufgefordert, dies zu bestätigen.

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

Nach der Umstellung wird das Azure-DevOps-Repository auf schreibgeschützt festgelegt. Wenn Sie wieder darauf schreiben möchten, fügen Sie --remove-read-only hinzu, um den Schreibzugriff wiederherzustellen. Diese Markierung gilt erst nach dem Cutover.

az devops migrations abandon --org https://dev.azure.com/<org>
                             --repository-id <repo-guid>
                             --remove-read-only

Um die interaktive Bestätigungsabfrage zu überspringen (für die skriptgesteuerte Bereinigung), fügen Sie --yes hinzu.

Nachdem Sie eine Migration abgebrochen haben:

  • Source-Repository: Ihr Azure DevOps Repository ist unverändert und vollständig schreibbar. Keine Bereinigung erforderlich
  • Audit-Protokoll: Der Migrationsdatensatz wird nicht aufbewahrt, aber es wird ein Audit-Ereignis protokolliert, das festhält, dass die Migration verworfen wurde. Weitere Informationen finden Sie unter "Audit".
  • Starten einer neuen Migration: Sie können eine neue Migration für dasselbe Quell-Repository erstellen, aber eine kurze Abkühlung gilt, bevor die neue Migration gestartet werden kann. Wenn Sie denselben Namen für das Ziel-GitHub-Repository wiederverwenden möchten, löschen Sie zuerst das vorhandene GitHub-Repository. Sie müssen in GitHub über die Berechtigung „Repository löschen“ verfügen, um dies zu tun.

Nächster Schritt

Umstellung auf GitHub

Verwandte Inhalte

  • Last updated on