Applying the imported data on GitHub Enterprise Server
Once you have prepared your migration you can use the following steps to complete the migration.
-
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 importaus, um den Importprozess zu starten. Sie benötigen Folgendes:- Ihren Migrations-GUID. For more information, see "Preparing to migrate data to your enterprise."
- 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_GUIDWenn 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/,renamedEs 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,failedKontaktieren 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. Weitere Informationen findest Du unter "Auf die administrative Shell (SSH) zugreifen."
$ 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
IDder 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
Nachdem Sie die Repositorys der GitHub.com-Organisation entsperrt haben, sollten Sie mithilfe des Endpunkts zum Löschen des Repositorys jedes Repository löschen, das Sie zuvor migriert haben. 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_nameRepositorys auf einer GitHub Enterprise Server-Instanz entsperren
- Stellen Sie eine SSH-Verbindung zu your GitHub Enterprise Server instance her. Weitere Informationen findest Du unter "Auf die administrative Shell (SSH) zugreifen."
$ 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