本文分享从 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 官方文档：通过直接转移迁移群组
