关于从 Bitbucket Server 迁移的迁移
您可以使用 GitHub Enterprise Importer 将仓库从 Bitbucket Server 迁移到 GitHub Enterprise Cloud（GitHub.com 或 GHE.com）。仅在 Bitbucket Server 或 Bitbucket Data Center 版本 5.14 及以上时才支持从 Bitbucket Server 进行迁移。
已迁移的数据
我们目前仅支持将以下仓库数据从 Bitbucket Server 迁移到 GitHub Enterprise Cloud。
-
Git 源代码（包括提交历史）
-
拉取请求（包括评论、拉取请求审查、文件和行级别的拉取请求审查评论、必需审查人以及附件）
注意
如果在迁移前，拉取请求已合并且在 Bitbucket Server 上删除了其源分支，用户在尝试查看该拉取请求时可能会收到
500错误。Bitbucket Server 会删除此类拉取请求对应的特定 Git 引用，导致与该拉取请求关联的 Git 对象无法迁移。
未迁移的数据
当前，以下数据未迁移。
- 用户拥有的个人仓库
- 分支权限
- 提交评论
- 仓库设置
- CI 流水线
迁移数据的限制
GitHub Enterprise Importer 能迁移的内容存在一定限制。部分限制来源于 GitHub 本身，另一些则是 GitHub Enterprise Importer 本身的限制。
GitHub 的限制
- 单个 Git 提交的 2 GiB 大小限制： 您的 Git 仓库中没有单个提交可以大于 2 GiB。如果有提交超过 2 GiB，您需要将其拆分为每个不超过 2 GiB 的更小提交。
- Git 引用 255 字节限制：没有单个Git 引用（通常称为 “ref”）的名称可以超过 255 字节。通常这意味着引用名称不能超过 255 个字符，但任何非ASCII字符（例如表情符号）可能占用多个字节。如果您的任何 Git 引用过长，我们将返回明确的错误信息。
- 100 MiB 文件大小限制：迁移完成后，Git 仓库中的任何单个文件都不能大于 100 MiB。在仓库迁移期间，此限制提升至 400 MiB。建议使用 Git LFS 来存储大文件。更多信息请参见管理大文件。
GitHub Enterprise Importer 的限制
- 40 GiB 仓库归档大小限制（公开预览）：Importer 无法迁移归档中 Git 数据和元数据总计超过 40 GiB 的仓库。
- 400 MiB 文件大小限制：使用 GitHub Enterprise Importer 迁移仓库时，Git 仓库中的任何单个文件都不能大于 400 MiB。建议使用 Git LFS 存储大文件。更多信息请参见管理大文件。
- Git LFS 对象未迁移：Importer 可以迁移使用 Git LFS 的仓库，但 LFS 对象本身不会被迁移。完成迁移后，您可以将这些对象推送到目标仓库作为后续任务。更多信息请参见复制仓库。
- 需要后续任务：在不同的 GitHub 产品之间迁移时，某些设置不会迁移，需在新仓库中重新配置。有关每次迁移后需完成的后续任务列表，请参见GitHub 产品之间迁移概览。
- 代码搜索功能延迟： 在仓库迁移后，重新索引搜索索引可能需要数小时，在重新索引完成之前，代码搜索可能返回意外结果。
- 组织配置的规则集可能导致迁移失败：例如，您配置了一个规则要求提交作者的电子邮件地址必须以
@monalisa.cat结尾，而待迁移的仓库中包含不符合此规则的提交，则迁移会失败。有关规则集的更多信息，请参见关于规则集。 - Mannequin 内容可能无法被搜索：Mannequin 是占位用户，导入的内容（如议题、拉取请求、评论等）会关联到它们。当您搜索与 Mannequin 关联的内容（例如已指派的议题）时，可能找不到这些议题。一旦 Mannequin 被重新认领，内容应可通过新所有者被检索到。更多信息请参见为 GitHub Enterprise Importer 重新认领 Mannequin。
入门指南
在从 Bitbucket Server 迁移之前，您应规划迁移的执行方式。在迁移任何数据之前，需要指定一个负责人来执行迁移，并为该人员授予源仓库和目标仓库的必要访问权限。我们还建议您先进行一次试运行迁移。
有关从头到尾的迁移流程概览，请参见从 Bitbucket Server 到 GitHub Enterprise Cloud 的迁移概览。