Zugreifen auf die Migrationsprotokolle für GitHub Enterprise Importer

Nach dem Ausführen einer Migration sollten Sie das Migrationsprotokoll überprüfen, um nach Daten zu suchen, die nicht wie erwartet migriert wurden.

In diesem Artikel

Informationen zu Migrationsprotokollen

Jedes Mal, wenn du mit GitHub Enterprise Importer eine Migration ausführst, wird ein Migrationsprotokoll erstellt. Sie sollten das Migrationsprotokoll nach jeder Migration überprüfen, um Migrationswarnungen zu üprüfen.

Im Migrationsprotokoll sind die Schritte aufgeführt, die im Rahmen der Migration abgeschlossen wurden. Außerdem enthält es zusätzliche Informationen.

  • Migrationswarnungen, die Daten darstellen (z. B. Probleme, Pull Requests oder Kommentare), die nicht wie erwartet migriert wurden
  • Wer hat die Migration ausgeführt?
  • Was war die Migrationsquelle?
  • Wie lange hat die Migration gedauert?

Du kannst auf verschiedene Arten auf das Migrationsprotokoll für eine Repositorymigration zugreifen.

  • Zeige in GitHub das Issue „Migrationsprotokoll“ im migrierten Repository an. Du kannst dieses Issue verwenden, um Warnungen mit deinem Team zu besprechen und Entscheidungen aufzuzeichnen.
  • Lade mit der GitHub CLI eine Protokolldatei herunter.

Wenn du eine Organisationsmigration ausführst, erstellt GitHub Enterprise Importer zusätzlich ein Repository mit dem Namen gei-migration-results in der Zielorganisation. Dieses Repository enthält Informationen zur Migration von Daten auf Organisationsebene und dupliziert die Informationen in den Issues „Migrationsprotokoll“ für jedes migrierte Repository.

Weitere Informationen zum Interpretieren von Warnungen im Migrationsprotokoll finden Sie unter „Behandeln von Problemen bei der Migration mit GitHub Enterprise Importer“.

Anzeigen des Migrationsprotokolls eines Repositorys in GitHub

Personen mit Lesezugriff auf ein Repository können auf das Migrationsprotokoll für das Repository in GitHub zugreifen.

  1. Navigiere zum migrierten Repository in deiner Zielorganisation.

  2. Klicke unter dem Namen deines Repositorys auf -Issues.

    Screenshot der Hauptseite eines Repositorys. In der horizontalen Navigationsleiste ist eine Registerkarte mit der Bezeichnung „Issues“ dunkelorange umrandet.

  3. Klicke auf das Issue mit dem Titel „Migrationsprotokoll“.

Herunterladen des Migrationsprotokolls eines Repositorys mit der GitHub CLI

Organisationsbesitzer*innen und Organisationsmitglieder mit der Migrationsrolle können Migrationsprotokolle mithilfe der GitHub CLI herunterladen.

Du kannst mit dem Befehl download-logs das neueste Migrationsprotokoll für ein einzelnes Repository herunterladen. Der genaue Befehl hängt von deiner Migrationsquelle ab.

Migrationsprotokolle können nach Abschluss der Migration 24 Stunden lang heruntergeladen werden.

Herunterladen des Migrationsprotokolls eines Repositorys mit der ADO2GH extension

Wenn deine Migrationsquelle Azure DevOps ist, kannst du das neueste Migrationsprotokoll für ein einzelnes Repository mit dem Befehl gh ado2gh download-logs herunterladen. Ersetze DESTINATION durch die Zielorganisation, REPOSITORY durch den Repositorynamen und FILENAME durch einen Dateinamen für die heruntergeladene Datei.

Shell
gh ado2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

Wenn du noch keine Umgebungsvariable GH_PAT für ein personal access token mit Zugriff auf die Zielorganisation hast, füge --github-target-pat TOKEN hinzu, und ersetze TOKEN durch das personal access token. Informationen zupersonal access token-Anforderungen sind unter „Verwalten des Zugriffs für eine Migration von Azure DevOps“ zu finden.

Herunterladen des Migrationsprotokolls eines Repositorys mit der BBS2GH extension

Wenn deine Migrationsquelle Bitbucket Server ist, kannst du das neueste Migrationsprotokoll für ein einzelnes Repository mit dem Befehl gh bbs2gh download-logs herunterladen. Ersetze DESTINATION durch die Zielorganisation, REPOSITORY durch den Repositorynamen und FILENAME durch einen Dateinamen für die heruntergeladene Datei.

Shell
gh bbs2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

Wenn du noch keine Umgebungsvariable GH_PAT für ein personal access token mit Zugriff auf die Zielorganisation hast, füge --github-target-pat TOKEN hinzu, und ersetze TOKEN durch das personal access token. Informationen zupersonal access token-Anforderungen sind unter „Verwalten des Zugriffs für eine Migration von Bitbucket Server“ zu finden.

Herunterladen des Migrationsprotokolls eines Repositorys mit der GEI extension

Wenn deine Migrationsquelle ein GitHub-Produkt ist, kannst du das neueste Migrationsprotokoll für ein einzelnes Repository mit dem Befehl gh gei download-logs herunterladen. Ersetze DESTINATION durch die Zielorganisation, REPOSITORY durch den Repositorynamen und FILENAME durch einen Dateinamen für die heruntergeladene Datei.

Shell
gh gei download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME

Wenn du noch keine Umgebungsvariable GH_PAT für ein personal access token mit Zugriff auf die Zielorganisation hast, füge --github-target-pat TOKEN hinzu, und ersetze TOKEN durch das personal access token. Informationen zupersonal access token-Anforderungen sind unter „Verwalten des Zugriffs für eine Migration zwischen GitHub-Produkten“ zu finden.

Herunterladen aller Repositorymigrationsprotokolle für ein Migrationsskript

Um sicherzustellen, dass du Zugriff auf Migrationsprotokolle für alle migrierten Repositorys hast, kannst du das Flag --download-migration-logs verwenden, wenn du ein Migrationsskript für Repositorymigrationsvorgänge generierst. Wenn du dieses Flag verwendest, enthält das Skript den Befehl download-logs für jedes Repository, das mit dem Skript migriert wurde. Weitere Informationen findest du unter Informationen zu GitHub Enterprise Importer.

Hinweis: Du kannst das Flag --download-migration-logs nur bei Repositorymigrationsvorgängen verwenden, aber nicht bei Organisationsmigrationsvorgängen.

Zugreifen auf das Migrationsprotokoll einer Organisation

Besitzer*innen der Zielorganisation können in GitHub auf das Migrationsprotokoll für eine Organisationsmigration zugreifen.

Um auf das Migrationsprotokoll für eine Organisationsmigration zuzugreifen, navigierst du zu dem Repository mit dem Namen gei-migration-results in deiner Zielorganisation.

Die Datei README.md im Stammverzeichnis des Repositorys enthält die folgenden Informationen zur Migration der Organisation:

  • Alle Warnungen oder Fehler im Zusammenhang mit der Migration von Daten auf Organisationsebene, z. B. Einstellungen und Teams
  • Die Anzahl der Repositorys, die erfolgreich migriert wurden, und die Anzahl der Repositorys, die nicht migriert werden konnten

Die Verzeichnisse /success und /failure enthalten eine Datei für jedes Repository, das erfolgreich migriert wurde bzw. das nicht migriert werden konnte. Für diese Dateien wird die Namenskonvention REPO_NAME.md verwendet.

Hinweis: Das Repository gei-migration-results wird zu Beginn des Migrationsprozesses erstellt, aber erst nach Abschluss der Migration mit deinen Migrationsprotokollen aktualisiert.