从 GitLab.com 到 JihuLab.com 的迁移指南

本文分享从 GitLab.com 到 JihuLab.com 的迁移指南。

近期，GitLab Inc. 针对其 SaaS 产品做了限制，如果被判定为国内用户，则会建议使用其在国内的发布版本极狐GitLab。从 GitLab SaaS 产品（GitLab.com）迁移到极狐GitLab SaaS 产品（JihuLab.com）非常方便，可以直接使用 GitLab 提供的直接转移迁移功能（direct transfer）。

直接转移迁移功能

直接转移迁移（direct transfer）功能可以完成如下几种方式的迁移：

• 从私有化部署实例到 JihuLab.com
• 从 JihuLab.com 到私有化部署实例
• 从一个私有化部署实例到另外一个私有化部署实例
• 同一个实例内的群组间迁移

从 GitLab.com 到 JihuLab.com 可以理解为两个实例之间的迁移。下面分享整个迁移过程。其中，GitLab.com 为源实例，JihuLab.com 为目标实例。

前提条件

• 您需要具有拥有者角色
• 实例之间需要支持 HTTPS
• 迁移之间的版本最好是最新或者较新版本（至少在 16.8 及以后）
• 在源实例上创建的个人访问令牌

迁移指南

第一步：创建个人访问令牌

首先需要在源实例上创建一个个人访问令牌，该令牌必须要有 api和 read_repository权限。可以通过 右上角头像 --> 偏好设置 --> 访问令牌 来创建所需的个人访问令牌。

第二步：导入群组

在源实例上选择 新建群组 --> 导入群组：

输入源实例 URL，即 GitLab.com，再输入第一步创建的个人访问令牌，然后选择 连接实例。接着就会列举出可以被导入的群组：

选择想要导入的群组，点击 导入 即可。可以在同一个界面上看到导入进度，如果完成的话，也会看到状态变成 完成。

点击 迁移详情 可以看到迁移过来的群组、项目以及条目等：

第三步：迁移检查

可以在目标实例上查看导入的群组或项目：

至此，选定的群组及下面的项目都已从 GitLab.com 迁移到 JihuLab.com。如有多个群组需要迁移，可以一个个迁移，也可以同时选中进行迁移，如果群组过大，建议一个个进行迁移，避免出现超时等问题。

故障排查

如果您在迁移过程中遇到任何问题，可以查阅官方文档进行资料查询，也可以在官方论坛发帖求助。

参考资料

• 极狐GitLab 官方文档：通过直接转移迁移群组