了解如何通过高效、安全的直接迁移方式，在极狐GitLab实例之间迁移群组和项目。

通过直接迁移方式迁移极狐GitLab群组和项目的功能现已在极狐GitLab 18.3 版本中全面可用。这为更广泛的用户提供了一种在极狐GitLab实例之间迁移资源的简便自动化方法。

使用直接迁移功能，您可以轻松地在相同或不同的极狐GitLab实例上创建选定资源的副本。您可以使用UI界面或API。UI界面直观易用，而API则为您在选择要复制的资源方面提供了额外的灵活性。

相较于通过文件导出迁移群组和项目，直接迁移是一项重大改进，原因如下：

• 您无需手动将每个群组和项目单独导出为文件，然后再将所有导出文件导入新位置。现在，您可以直接迁移您拥有所有者角色的任何顶级群组及其所有子群组和项目。
• 它支持迁移后用户贡献映射（例如议题或评论的作者身份），为您提供了更大的灵活性和控制力。
• 它能够可靠地处理大型项目。得益于资源分批处理以及导入导出过程的并发执行，中断或超时的可能性显著降低。
• 它在迁移过程中及完成后提供更深入的洞察。在UI界面中，您可以观察到随着导入项增加而增长的数字。然后您可以查看导入结果。在极狐GitLab UI中，导入成功的项目会显示已导入徽章。

自极狐GitLab 14.3 开始支持群组资源的直接迁移以来，我们已经走过了很长的路。在极狐GitLab 15.8 中，我们将此功能作为测试版扩展到了项目迁移。此后，我们一直致力于提高导入的效率和可靠性，特别是对于大型项目。我们从安全性和实例稳定性的角度对该功能进行了全面审查。

以下是我们测试过的一些群组和项目的规模及其导入时长的示例：

100 个项目（19.9k 个议题，83k 个合并请求，100k+ 条流水线）在 8 小时内完成迁移

1,926 个项目（22k 个议题，160k 个合并请求，110 万条流水线）在 34 小时内完成迁移

在极狐GitLab 上，直接迁移功能默认启用。在私有化部署版和极狐GitLab Dedicated 上，管理员必须在应用设置中启用此功能。

何时使用直接迁移以及如何获得最佳结果

直接迁移要求实例之间或与极狐GitLab.com 有网络连接。因此，使用隔离网络（其极狐GitLab实例之间无连接）的客户仍必须使用文件导出来复制其极狐GitLab数据。在我们扩展此解决方案以支持离线实例后，他们将能够使用直接迁移功能迁移群组和项目。

在尝试迁移之前，请查阅文档，包括先决条件、可迁移的群组项和可迁移的项目项。某些项目会被排除在迁移之外或尚未支持迁移。

在尽可能新的版本之间迁移

我们建议在尽可能新的版本之间进行迁移。更新源实例和目标实例以利用我们随时间添加的所有改进和错误修复。

为迁移后的用户贡献映射做准备

熟悉用户贡献和成员关系映射流程，以便了解迁移完成后会发生什么以及您需要采取的后续步骤。

审查减少迁移时长的选项

根据您要迁移到的目标（极狐GitLab、私有化部署实例或 Dedicated），您可以采用各种策略来减少迁移时长。

如何查看迁移结果？

您可以在群组导入历史页面上查看所有通过直接迁移方式迁移的群组和项目。对于每个群组和项目，您可以查看导入项的统计数据，并在某些项未导入时深入查看详情。或者，您可以使用API端点实现相同目的。

如果您的项目大部分成功完成，但有一两个项目缺少某些关系（如合并请求或议题），我们建议您尝试使用API重新导入这些项目。

直接迁移功能的下一步计划是什么？

我们很高兴能将直接迁移功能推向全面可用，希望您也一样！我们想听听您的意见。对您来说，最重要的缺失功能是什么？我们还能改进什么？请在直接迁移功能反馈议题中告诉我们，我们将持续迭代改进！