导出 GitHub Enterprise Server 源仓库

1. SSH 到 您的 GitHub Enterprise Server 实例。

   $ ssh -p 122 admin@HOSTNAME

2. 要准备需要导出的仓库，请使用 ghe-migrator add 命令和仓库的 URL：

   • 如果您要锁定仓库，请在命令后附加 --lock。 如果您执行的是试运行，则不需要 --lock。 shell $ ghe-migrator add https://hostname/username/reponame --lock

   • 您可以将 --exclude_attachments 附加到命令，排除文件附件。 文件附件可能很大，可能不必要地胀大您的最终迁移存档。

   • 要一次准备多个将导出的仓库，请创建一个文本文件并在单独的行中列出每个仓库 URL，然后运行包含 -i 标志和您的文本文件路径的 ghe-migrator add 命令。 shell $ ghe-migrator add -i PATH/TO/YOUR/REPOSITORY_URLS.txt

3. 出现提示时，请输入您的 GitHub Enterprise Server 用户名：

   Enter username authorized for migration:  admin

4. 出现输入个人访问令牌的提示时，请输入您在“准备 GitHub Enterprise Server 源实例”中创建的访问令牌：

   Enter personal access token:  **************

5. 在 ghe-migrator add 完成后，它将打印自身生成并用于标识此导出的唯一的“迁移 GUID”以及添加到导出中的资源列表。 在后续的 ghe-migrator add 和 ghe-migrator export 步骤中，您将使用它生成的迁移 GUID 指示 ghe-migrator 继续在同一个导出上操作。

   > 101 models added to export
   > Migration GUID: example-migration-guid
   > Number of records in this migration:
   > users                        |  5
   > organizations                |  1
   > repositories                 |  1
   > teams                        |  3
   > protected_branches           |  1
   > pull_request_reviews         |  1
   > milestones                   |  1
   > issues                       |  3
   > pull_requests                |  5
   > pull_request_review_comments |  4
   > commit_comments              |  2
   > issue_comments               | 10
   > issue_events                 | 63
   > releases                     |  3
   > attachments                  |  4
   > projects                     |  2

每次您添加包含现有迁移 GUID 的新仓库时，它都会更新现有导出。 如果您在不使用迁移 GUID 的情况下重新运行 ghe-migrator add，它将启动新导出并生成一个新的迁移 GUID。 在您开始准备要导入的迁移时，请勿重用导出期间生成的迁移 GUID。

3. 如果您锁定了源仓库，则可以使用 ghe-migrator target_url 命令，在链接到仓库新位置的仓库页面上设置自定义锁定消息。 传递源仓库 URL、目标仓库 URL 和第 5 步中的迁移 GUID：

   $ ghe-migrator target_url https://hostname/username/reponame https://target_hostname/target_username/target_reponame -g MIGRATION_GUID

4. 要向同一个导出添加更多仓库，请使用包含 -g 标志的 ghe-migrator add 命令。 您需要传入新仓库 URL 和第 5 步中的迁移 GUID：

   $ ghe-migrator add https://hostname/username/other_reponame -g MIGRATION_GUID --lock

5. 添加完仓库后，请使用包含 -g 标志和第 5 步中的迁移 GUID 的 ghe-migrator export 命令生成迁移存档：

   $ ghe-migrator export -g MIGRATION_GUID
     > Archive saved to: /data/github/current/tmp/MIGRATION_GUID.tar.gz

6. SSH 到 您的 GitHub Enterprise Server 实例。

   $ ssh -p 122 admin@HOSTNAME

7. 断开与 您的 GitHub Enterprise Server 实例 的连接：

   $ exit
   > logout
   > Connection to hostname closed.

8. 使用 scp 命令将迁移存档复制到您的计算机。 存档文件将使用迁移 GUID 命名：

   $ scp -P 122 admin@hostname:/data/github/current/tmp/MIGRATION_GUID.tar.gz ~/Desktop

9. 要将存档的迁移数据导入 GitHub Enterprise Server 实例，请参阅“将迁移数据导入 GitHub Enterprise Server”。