Informationen zu Migrationsprotokollen
Jedes Mal, wenn du mit GitHub Enterprise Importer eine Migration ausführst, wird ein Migrationsprotokoll erstellt. Du solltest das Migrationsprotokoll nach jeder Migration auf Migrationswarnungen überprü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 übertragen 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 findest du 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.
-
Navigiere zum migrierten Repository in deiner Zielorganisation.
-
Klicke unter dem Namen deines Repositorys auf -Issues.
-
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.
- Herunterladen des Migrationsprotokolls eines Repositorys mit der ADO2GH extension
- Herunterladen des Migrationsprotokolls eines Repositorys mit der BBS2GH extension
- Herunterladen des Migrationsprotokolls eines Repositorys mit der GEI extension
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.
gh ado2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
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.
gh bbs2gh download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
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.
gh gei download-logs --github-target-org DESTINATION --target-repo REPOSITORY --migration-log-file FILENAME
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.