Migrating data to your enterprise

Applying the imported data on GitHub Enterprise Server

1. Stelle als ein Websiteadministrator eine SSH-Verbindung zur GitHub Enterprise Server-Instanz her.

   $ ssh -p 122 admin@HOSTNAME

2. 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). For more information, see "Creating a personal access token."

   $ 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

Filter für Datensatzzustände

Ü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

1. Stelle eine SSH-Verbindung zu Ihre GitHub Enterprise Server-Instanz her.

   $ ssh -p 122 admin@HOSTNAME

2. 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

1. Stelle eine SSH-Verbindung zu Ihre GitHub Enterprise Server-Instanz her.

   $ ssh -p 122 admin@HOSTNAME

2. 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