GitHub 企业实时迁移正式可用后哪些数据可以迁移

GitHub Enterprise Live Migrations（ELM）正式可用后，企业迁移的关键变化不是“所有 GitHub 数据都能自动搬家”，而是可以把单个仓库的大部分仓库级数据在持续同步下迁到 GitHub Enterprise Cloud with Data Residency（GHE.com）。组织设置、团队、项目和组织级 Webhook 不在迁移范围内；规则集不迁移，分支保护也只是部分迁移。

先判断仓库是否适合 Enterprise Live Migrations

ELM 的价值在于降低开发者等待时间：初始回填后，源仓库仍可继续工作，Webhook 会把部分后续变化交给迁移服务；到 cutover 时，源仓库才会短暂变为只读。GitHub 官方把它定位为 GEI 的补充，而不是所有仓库的默认替代品。

可以先按下面四个问题筛选：

如果仓库可以接受短暂停机、规模也不大，GEI 可能更简单。ELM 更适合把“停机风险”当作主要约束的仓库，而不是单纯追求功能数量。

仓库级数据能带走什么

ELM 一次迁移一个仓库，覆盖范围集中在仓库本身。代码侧包括 refs、对象和完整提交历史；启用条件满足时，LFS 对象和 Wiki Git 仓库也会迁移。协作侧包括 Issues、评论、反应、标签关联、时间线事件，以及 Pull requests、评审、行内评论和评审线程。

仓库设置和发布资产也不能漏盘：仓库描述、可见性、默认分支、启用功能、仓库 Webhook、Topics、Pull request 设置、仓库级 Actions 配置、Autolinks、Pages、Labels、Milestones、Releases、Commit comments、Status checks、Check runs 和 Check suites 都在官方迁移数据清单中。Release asset 的单个文件上限是 2GB，LFS 则要求源端已启用 LFS。

最容易误判的缺口在哪里

第一类缺口是“仓库数据”和“组织数据”的边界。组织设置、Teams、Projects、组织级 Webhooks 不会随仓库迁移；ELM 至多在目标端创建目标组织账号，组织结构和权限仍要人工配置。

第二类缺口是保护规则。Repository rulesets 不迁移；分支保护只保留部分开关状态，不保留允许的用户、团队或应用，也不会带走绕过者、强推者、状态检查应用绑定、合并队列和部署要求等配置。迁移后必须在允许开发者工作前重新检查。

第三类缺口是实时更新。Pull request 的创建、编辑、关闭等事件有支持范围，但例如 review requested、synchronize、locked 等事件不在实时更新列表中；Check runs、Check suites 和 Pages 配置只在初始回填阶段导出，不会继续由 Webhook 更新。

上线前用清单决定迁移方式

建议把迁移拆成“能自动带走”和“必须人工接手”两张清单。操作人需要同时具备 GHES site admin 和 GHE.com enterprise owner 权限，并准备源端和目标端的 classic personal access token。多个并发迁移还应由同一操作人使用同一组令牌执行。

1. 前置检查：确认 GHES 补丁版本、HTTPS、出站网络、Migrations 开关、LFS 状态和 2GB 资产限制。
2. 仓库盘点：记录规则集、分支保护允许列表、组织 Teams/Projects、组织 Webhook，以及正在进行的评审和发布。
3. 沟通冻结：通知开发者迁移期间不要 force push；cutover 后源仓库会归档并只读，未支持的动作不能假定会补到目标端。
4. 切换复核：完成后检查提交历史、Issues、Pull requests、Releases、Webhook、权限和保护规则，再恢复正常发布。

这个清单也给出了工具选择：能接受停机且仓库简单的项目优先评估 GEI；大型 monorepo、活跃仓库或停机会阻塞业务的项目优先评估 ELM；组织级配置无论使用哪种工具，都要单独安排目标端重建。

常见问题

ELM 是迁移整个 GitHub Enterprise 企业吗？

不是。一次 ELM 迁移只包含一个仓库，组织设置、团队、项目和组织 Webhook 需要在目标企业重新配置。

分支保护会完整保留吗？

不会。部分限制状态会迁移，但允许主体、绕过者、强推者、状态检查绑定、合并队列和部署要求等需要复核或重建。

迁移期间可以继续提交代码吗？

大部分回填和实时更新阶段可以继续使用源仓库，但应避免 force push；开始 cutover 后源仓库会归档，开发者需要转到新的位置。

Check runs 会持续同步到目标端吗？

不会。官方数据说明中，Check runs 和 Check suites 只在初始回填导出，不属于持续实时更新项目。

发布说明与数据范围可从 GitHub Changelog、ELM 概览 和 迁移数据参考核对。