本文分享从 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。如有多个群组需要迁移,可以一个个迁移,也可以同时选中进行迁移,如果群组过大,建议一个个进行迁移,避免出现超时等问题。
故障排查
如果您在迁移过程中遇到任何问题,可以查阅官方文档进行资料查询,也可以在官方论坛发帖求助。