Applying the imported data on GitHub Enterprise Server
-
Stellen Sie als ein Websiteadministrator eine SSH-Verbindung zur GitHub Enterprise Server-Instanz her.
$ ssh -p 122 admin@HOSTNAME
-
Führen Sie den Befehl
ghe-migrator import
aus, um den Importprozess zu starten. Sie benötigen Folgendes:- Ihren Migrations-GUID.
- Dein persönliches Zugangs-Token für die Authentifizierung. Das persönliche Zugriffstoken, das Du verwendest, dient nur der Authentifizierung als Website-Administrator und erfordert keinen bestimmten „Scope“ (Geltungsbereich). Weitere Informationen finden Sie unter "Erstellen eines persönlichen Zugriffstokens."
$ ghe-migrator import /home/admin/MIGRATION_GUID.tar.gz -g MIGRATION_GUID -u username -p TOKEN > Starting GitHub::Migrator > Import 100% complete /
- Ergänze den Befehl mit
--staging-path=/full/staging/path
, um anzugeben, wo die Migrationsdateien vorgemerkt werden sollen. Der Standardwert lautet/data/user/tmp
.
Migrationsdaten überprüfen
Der Befehl ghe-migrator audit
gibt standardmäßig jeden Datensatz zurück. Dadurch können Sie die Datensätze zudem filtern nach
- den Datensatztypen,
- dem Zustand der Datensätze.
Die Datensatztypen stimmen mit denen der Migrationsdaten überein.
Filter für Datensatztypen
Datensatztyp | Filtername |
---|---|
Benutzer | Benutzer |
Organisationen | Organisation |
Repositorys | Repository |
Teams | Team |
Meilensteine | Meilensteine |
Projektboards | project (Projekt) |
Issues | Issue |
Issue-Kommentare | issue_comment |
Pull Requests | pull_request |
Pull-Request-Reviews | pull_request_review |
Commit-Kommentare | commit_comment |
Pull-Request-Review-Kommentare | pull_request_review_comment |
Veröffentlichungen | Release |
Bei Pull Requests oder Issues ergriffene Maßnahmen | issue_event |
geschützte Branches | protected_branch |
Filter für Datensatzzustände
Datensatzzustand | Beschreibung |
---|---|
export | Der Datensatz wird exportiert. |
import | Der Datensatz wird importiert. |
map | Der Datensatz wird zugeordnet. |
rename | Der Datensatz wird umbenannt. |
Merge | Der Datensatz wird gemergt. |
exported | Der Datensatz wurde erfolgreich exportiert. |
imported | Der Datensatz wurde erfolgreich importiert. |
mapped | Der Datensatz wurde erfolgreich zugeordnet. |
renamed | Der Datensatz wurde erfolgreich umbenannt. |
merged | Der Datensatz wurde erfolgreich gemergt. |
failed_export | Fehler beim Export des Datensatzes. |
failed_import | Fehler beim Import des Datensatzes. |
failed_map | Fehler beim Zuordnen des Datensatzes. |
failed_rename | Fehler beim Umbenennen des Datensatzes. |
failed_merge | Fehler beim Mergen des Datensatzes. |
Überwachte Datensätze filtern
Wenn Sie den Befehl ghe-migrator audit
mit dem Flag -m
ausführen, können Sie anhand des Datensatztyps filtern. Ebenso können Sie mithilfe des Flags -s
nach dem Importstatus filtern. Der Befehl sieht wie folgt aus:
$ ghe-migrator audit -m RECORD_TYPE -s STATE -g MIGRATION_GUID
Wenn Sie beispielsweise alle erfolgreich importierten Organisationen und Teams anzeigen möchten, würden Sie Folgendes eingeben:
$ ghe-migrator audit -m organization,team -s mapped,renamed -g MIGRATION_GUID
> model_name,source_url,target_url,state
> organization,https://gh.source/octo-org/,https://ghe.target/octo-org/,renamed
Es wird dringend empfohlen, jeden fehlgeschlagenen Import zu überwachen. Dazu geben Sie Folgendes ein:
$ ghe-migrator audit -s failed_import,failed_map,failed_rename,failed_merge -g MIGRATION_GUID
> model_name,source_url,target_url,state
> user,https://gh.source/octocat,https://gh.target/octocat,failed
> repository,https://gh.source/octo-org/octo-project,https://ghe.target/octo-org/octo-project,failed
Kontaktieren Sie GitHub Enterprise-Support oder GitHub Premium-Support, wenn Sie Bedenken in Bezug auf fehlgeschlagene Importvorgänge haben.
Completing the import on GitHub Enterprise Server
After your migration is applied to your target instance and you have reviewed the migration, you''ll unlock the repositories and delete them off the source. Vor dem Löschen Ihrer Quelldaten sollten Sie etwa zwei Wochen warten, um sicherzugehen, dass alles erwartungsgemäß funktioniert.
Repositorys auf der Zielinstanz entsperren
- Stellen Sie eine SSH-Verbindung zu your GitHub Enterprise Server instance her.
$ ssh -p 122 admin@HOSTNAME
- Entsperre alle importierten Repositorys mithilfe des Befehls
ghe-migrator unlock
. Du benötigst Deine Migrations-GUID:$ ghe-migrator unlock -g MIGRATION_GUID > Unlocked octo-org/octo-project
Repositorys auf der Quellinstanz entsperren
Unlocking repositories from an organization on GitHub.com
Um die Repositorys in einer GitHub.com-Organisation zu entsperren, senden Sie eine DELETE
-Anforderung an den Endpunkt zum Entsperren der Migration. Sie benötigen Folgendes:
- Ihr Zugriffstoken für die Authentifizierung
- die eindeutige
ID
der Migration - den Namen des zu entsperrenden Repositorys
curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \ -H "Accept: application/vnd.github.wyandotte-preview+json" \ https://api.github.com/orgs/orgname/migrations/id/repos/repo_name/lock
Deleting repositories from an organization on GitHub.com
After unlocking the GitHub.com organization's repositories, you should delete every repository you previously migrated using the repository delete endpoint. Sie benötigen Ihr Zugriffstoken für die Authentifizierung:
curl -H "Authorization: token GITHUB_ACCESS_TOKEN" -X DELETE \
https://api.github.com/repos/orgname/repo_name
Repositorys auf einer GitHub Enterprise Server-Instanz entsperren
- Stellen Sie eine SSH-Verbindung zu your GitHub Enterprise Server instance her.
$ ssh -p 122 admin@HOSTNAME
- Entsperre alle importierten Repositorys mithilfe des Befehls
ghe-migrator unlock
. Du benötigst Deine Migrations-GUID:$ ghe-migrator unlock -g MIGRATION_GUID > Unlocked octo-org/octo-project