Skip to main content
我们经常发布文档更新,此页面的翻译可能仍在进行中。 有关最新信息,请访问英语文档

此版本的 GitHub Enterprise 已停止服务 2023-03-15. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

将数据迁移到 GitHub Enterprise Server

生成迁移存档后,您可以将数据导入目标 GitHub Enterprise Server 实例。 在将变更永久应用到目标实例之前,您需要检查变更,查看有无潜在的冲突。

在 GitHub Enterprise Server 上应用导入的数据

在将数据迁移到 GitHub Enterprise Server 之前,必须准备数据并解决任何冲突。 有关详细信息,请参阅“准备将数据迁移到 GitHub Enterprise Server”。

在准备数据并解决冲突后,您可以将导入的数据应用于 GitHub Enterprise Server。

  1. 作为站点管理员,通过 SSH 连接到目标 GitHub Enterprise Server 实例

    $ ssh -p 122 admin@HOSTNAME
  2. 使用 ghe-migrator import 命令启动导入过程。 需要:

    $ ghe-migrator import /home/admin/MIGRATION-GUID.tar.gz -g MIGRATION-GUID -u USERNAME -p TOKEN
    
    > Starting GitHub::Migrator
    > Import 100% complete /
    • 要指定迁移文件的暂存位置,请在命令后附加 --staging-path=/full/staging/path。 默认为 /data/user/tmp

检查迁移数据

默认情况下,ghe-migrator audit 返回每条记录。 它还可以让您按以下方式筛选记录:

  • 记录的类型。
  • 记录的状态。

记录类型与迁移数据中的记录类型相匹配。

记录类型筛选器

记录类型筛选器名称
用户user
组织organization
存储库repository
Teamsteam
里程碑milestone
项目板project
问题issue
问题评论issue_comment
拉取请求pull_request
拉取请求审查pull_request_review
提交注释commit_comment
拉取请求审查评论pull_request_review_comment
版本release
在拉取请求或问题上进行的操作issue_event
受保护的分支protected_branch

记录状态筛选器

记录状态说明
export将导出记录。
import将导入记录。
map将映射记录。
rename将重命名记录。
merge将合并记录。
exported已成功导出记录。
imported已成功导入记录。
mapped已成功映射记录。
renamed已成功重命名记录。
merged已成功合并记录。
failed_export记录导出失败。
failed_import记录导入失败。
failed_map记录映射失败。
failed_rename记录重命名失败。
failed_merge记录合并失败。

筛选审核的记录

通过 ghe-migrator audit 命令,可以使用 -m 标志根据记录类型进行筛选。 同样,可以使用 -s 标志筛选导入状态。 命令如下所示:

$ ghe-migrator audit -m RECORD_TYPE -s STATE -g MIGRATION-GUID

例如,要查看每个成功导入的组织和团队,您可以输入:

$ 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

我们强烈建议审核每个失败的导入。 为此,你将输入:

$ 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

如果您对失败的导入有任何疑问,请联系 GitHub Enterprise 支持

在 GitHub Enterprise Server 上完成导入

在迁移应用到目标实例并且您已审查迁移后,您需要解锁仓库并将其从源中删除。 我们建议等待两周再删除您的源数据,以便确保所有数据都能按预期运行。

在目标实例上解锁仓库

  1. 通过 SSH 连接到 你的 GitHub Enterprise Server 实例。 如果实例包含多个节点,例如,如果配置了高可用性或异地复制,则通过 SSH 连接到主节点。 如果使用群集,则可以通过 SSH 连接到任何节点。 有关 SSH 访问权限的详细信息,请参阅“访问管理 shell (SSH)”。

    $ ssh -p 122 admin@HOSTNAME
  2. 使用 ghe-migrator unlock 命令解锁所有导入的存储库。 您将需要迁移 GUID:

    $ ghe-migrator unlock -g MIGRATION-GUID
    > Unlocked octo-org/octo-project

在源上解锁仓库

从 GitHub.com 上的组织解锁仓库

若要解锁 GitHub.com 组织上的存储库,你需要向迁移解锁终结点发送 DELETE 请求。 需要:

  • 身份验证的访问令牌
  • 迁移的唯一 id
  • 要解锁的仓库的名称
curl -H "Authorization: Bearer GITHUB_ACCESS_TOKEN" -X DELETE \
  -H "Accept: application/vnd.github.wyandotte-preview+json" \
  https://api.github.com/orgs/ORG-NAME/migrations/ID/repos/REPO_NAME/lock

从 GitHub.com 上的组织中删除仓库

解锁 GitHub.com 组织的存储库后,应该删除之前使用存储库删除终结点迁移的每个存储库。 您需要身份验证的访问令牌:

curl -H "Authorization: Bearer GITHUB_ACCESS_TOKEN" -X DELETE \
  https://api.github.com/repos/ORG-NAME/REPO_NAME

从 GitHub Enterprise Server 实例解锁仓库

  1. 通过 SSH 连接到 你的 GitHub Enterprise Server 实例。 如果实例包含多个节点,例如,如果配置了高可用性或异地复制,则通过 SSH 连接到主节点。 如果使用群集,则可以通过 SSH 连接到任何节点。 有关 SSH 访问权限的详细信息,请参阅“访问管理 shell (SSH)”。

    $ ssh -p 122 admin@HOSTNAME
  2. 使用 ghe-migrator unlock 命令解锁所有导入的存储库。 您将需要迁移 GUID:

    $ ghe-migrator unlock -g MIGRATION-GUID
    > Unlocked octo-org/octo-project