Hallo, Entdecker! An dieser Seite wird aktiv gearbeitet, oder sie wird noch übersetzt. Die neuesten und genauesten Informationen findest Du in unserer englischsprachigen Dokumentation.

Diese Version von GitHub Enterprise wird eingestellt am Diese Version von GitHub Enterprise wurde eingestellt am 2020-08-20. Es wird keine Patch-Freigabe vorgenommen, auch nicht für kritische Sicherheitsprobleme. Für eine bessere Leistung, verbesserte Sicherheit und neue Features nimm ein Upgrade auf die neueste Version von GitHub Enterprise vor. Wende Dich an den GitHub Enterprise-Support, um Hilfe beim Upgrade zu erhalten.

Artikelversion: Enterprise Server 2.18

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.

Inhalt dieses Artikels

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

DatensatztypFiltername
BenutzerBenutzer
Organisationenorganization
RepositorysRepository
TeamsTeam
MeilensteineMeilensteine
Projektboardsproject
IssuesIssue
Issue-Kommentareissue_comment
Pull Requestspull_request
Pull-Request-Reviewspull_request_review
Commit-Kommentarecommit_comment
Pull-Request-Review-Kommentarepull_request_review_comment
Veröffentlichungenveröffentlichen
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. 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

Menschliche Unterstützung einholen

Du kannst das Gesuchte nicht finden?

Kontakt