Migrating data to your enterprise

Nachdem Sie ein Migrationsarchiv generiert haben, können Sie die Daten auf Ihrer GitHub Enterprise Server-Zielinstanz importieren. Sie können die Änderungen auf potenzielle Konflikte überprüfen, bevor Sie die Änderungen dauerhaft auf Ihre Zielinstanz anwenden.

Applying the imported data on GitHub Enterprise Server

Once you have prepared your migration you can use the following steps to complete the migration.

  1. Stellen Sie 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:

    $ 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

DatensatztypFiltername
BenutzerBenutzer
OrganisationenOrganisation
RepositorysRepository
TeamsTeam
MeilensteineMeilensteine
Projektboardsproject (Projekt)
IssuesIssue
Issue-Kommentareissue_comment
Pull Requestspull_request
Pull-Request-Reviewspull_request_review
Commit-Kommentarecommit_comment
Pull-Request-Review-Kommentarepull_request_review_comment
VeröffentlichungenRelease
Bei Pull Requests oder Issues ergriffene Maßnahmenissue_event
geschützte Branchesprotected_branch

Filter für Datensatzzustände

DatensatzzustandBeschreibung
exportDer Datensatz wird exportiert.
importDer Datensatz wird importiert.
mapDer Datensatz wird zugeordnet.
renameDer Datensatz wird umbenannt.
MergeDer Datensatz wird gemergt.
exportedDer Datensatz wurde erfolgreich exportiert.
importedDer Datensatz wurde erfolgreich importiert.
mappedDer Datensatz wurde erfolgreich zugeordnet.
renamedDer Datensatz wurde erfolgreich umbenannt.
mergedDer Datensatz wurde erfolgreich gemergt.
failed_exportFehler beim Export des Datensatzes.
failed_importFehler beim Import des Datensatzes.
failed_mapFehler beim Zuordnen des Datensatzes.
failed_renameFehler beim Umbenennen des Datensatzes.
failed_mergeFehler 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

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

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_name

Repositorys auf einer GitHub Enterprise Server-Instanz entsperren

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

Did this doc help you?Privacy policy

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

Oder, learn how to contribute.