把项目从 GitHub 迁移到极狐 GitLab 有多种方式，可以直接在极狐 GitLab 创建项目的页面选择 import from GitHub，通过“一键式”来完成迁移，也可以使用 API 的方式通过“分步式”完成迁移。下面将分别进行展示。
通过 import（下面的“一键式”迁移） 方式来迁移的项目只适合非企业版 GitHub。企业版 GitHub 的项目迁移建议用“分步式”迁移，也就是通过 API 的方式来进行。
一键式迁移
从 GitHub 到极狐 GitLab 最简单的迁移方式就是在创建项目时，选择 import project 选项：
接着选择 GitHub 即可：
随后需要输入 GitHub 的 Personal Access Token 来 list 出 GitHub 账号下面的所有 Repo，选择想要 import 的项目即可完成项目迁移。这是最简单的迁移方式。
分步式迁移
分步式迁移是利用 GitHub 与极狐 GitLab 自身的 API 来完成数据的导出（GitHub 为导出方）、导入（极狐 GitLab 为导入方）。可以分以下两种情况分别进行导入。
个人账号下的仓库迁移
个人账号下的仓库指不在任何一个 organization 下面的项目，这种情况的迁移很简单，只需要确认需要从 GitHub 导出的 Repo，找到 Repo ID，然后调用极狐 GitLab 的 import API 即可。下面进行演示。
前提条件
极狐 GitLab 创建 Personal Access Token 的方法如下：
GitHub 创建 Personal Access Token 的方法和极狐 GitLab 类似：右上角用户信息 –> Settings –> Developer settings –> Personal access tokens。
获取 GitHub Repo ID
获取 Demo Repo：https://github.com/majinghe/tekton-demo 的 Repo ID：
$ curl -ks https://api.github.com/repos/majinghe/tekton-demo{ "id": 374861350, "node_id": "MDEwOlJlcG9zaXRvcnkzNzQ4NjEzNTA=", "name": "tekton-demo", "full_name": "majinghe/tekton-demo", "private": false, "owner": { "login": "majinghe", "id": 42570491, "node_id": "MDQ6VXNlcjQyNTcwNDkx", "avatar_url": "https://avatars.githubusercontent.com/u/42570491?v=4", "gravatar_id": "", "url": "https://api.github.com/users/majinghe", "html_url": "https://github.com/majinghe", "followers_url": "https://api.github.com/users/majinghe/followers", "following_url": "https://api.github.com/users/majinghe/following{/other_user}", "gists_url": "https://api.github.com/users/majinghe/gists{/gist_id}", "starred_url": "https://api.github.com/users/majinghe/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/majinghe/subscriptions", "organizations_url": "https://api.github.com/users/majinghe/orgs", "repos_url": "https://api.github.com/users/majinghe/repos", "events_url": "https://api.github.com/users/majinghe/events{/privacy}", "received_events_url": "https://api.github.com/users/majinghe/received_events", "type": "User", "site_admin": false }, "html_url": "https://github.com/majinghe/tekton-demo", "description": "Tekton demo", "fork": false, "url": "https://api.github.com/repos/majinghe/tekton-demo", ......太长，只保留部分信息...... "visibility": "public", "forks": 0, "open_issues": 2, "watchers": 0, "default_branch": "main", "temp_clone_token": null, "network_count": 0, "subscribers_count": 1}
复制代码
返回值的第一行 "id": 374861350, 就是该 Repo 的 Repo ID。接下来调用极狐 GitLab import API 导入即可。
导入极狐 GitLab
调用极狐 GitLab 的 import API，将上述 GitHub Repo 导入极狐 GitLab，API 为：
$ curl --request POST \ --url "https://gitlab.example.com/api/v4/import/github" \ --header "content-type: application/json" \ --header "PRIVATE-TOKEN: your-jh-gitlab-personal-access-token" \ --data '{ "personal_access_token": "your-github-personal-access-token", "repo_id": "12345", "target_namespace": "group/subgroup", "new_name": "NEW-NAME", "github_hostname": "https://github.example.com"}'
复制代码
参数说明：
–url：极狐 GitLab 实例地址；
PRIVATE-TOKEN：极狐 GitLab Personal Access Token，参考前提环节进行获取；
personal_access_token：GitHub Personal Access Token，参考前提环节进行获取；
repo_id：上一步获取的 GitHub Repo ID；
target_namespace：极狐 GitLab 中，导入项目所在的 Group/SubGroup；
new_name：导入项目在极狐 GitLab 中的项目名称；
github_hostname：GitHub 实例地址，如果是 github.com，则可不写；
将上述获取的 Personal Access Token 以及 Repo ID 分别替换，然后执行如下命令进行导入：
$ curl --request POST \ --url "https://gitlab.cn/api/v4/import/github" \ --header "content-type: application/json" \ --header "PRIVATE-TOKEN: jh-gitlab-personal-token" \ --data '{ "personal_access_token": "github-personal-access-token", "repo_id": "374861350", "target_namespace": "xiaomage", "new_name": "jh-tekton-demo"}'
复制代码
可以看到返回值：
{ "id":13535, "name":"jh-tekton-demo", "full_path":"/xiaomage/jh-tekton-demo", "full_name":"xiaomage / jh-tekton-demo"}
复制代码
可以看到极狐 GitLab 中，项目的 ID 为 13535，name 为 jh-tekton-demo，所在的 Group/Subgroup 为 xiaomage。可以在极狐 GitLab 实例界面上进行查看：
可以看到 issue，PR（极狐 GitLab 中自动转换为 MR）一并进行了导入。接下来就可以在极狐 GitLab 中进行协作开发了。
Organization 下面的仓库迁移
极狐 GitLab 没有 organization 这样的概念，但是有 Group/Subgroup 来对项目（Project）进行编排管理。GitHub organization 与极狐 GitLab Group/Subgroup 的转换示意图如下：
以 https://github.com/opensource-f2f/episode 为例，说明 organization 下面的仓库迁移。episode 是位于 organization opensource-f2f 下的一个 Repo。
获取 Organization 信息
可以用 API 来 list 某个账号下面的所有 organization，也可以 list 出某个具体 organization 的详细信息。两种方式都可以获取到 organization ID。比如用如何命令 list 出所有的 Organizations：
$ curl -i -H "Authorization: token your-github-personal-access-token" \ https://api.github.com/user/orgs
复制代码
可以得到如下返回结果：
[ { "login": "k8smeetup", "id": 30145889, "node_id": "MDEyOk9yZ2FuaXphdGlvbjMwMTQ1ODg5", "url": "https://api.github.com/orgs/k8smeetup", "repos_url": "https://api.github.com/orgs/k8smeetup/repos", "events_url": "https://api.github.com/orgs/k8smeetup/events", "hooks_url": "https://api.github.com/orgs/k8smeetup/hooks", "issues_url": "https://api.github.com/orgs/k8smeetup/issues", "members_url": "https://api.github.com/orgs/k8smeetup/members{/member}", "public_members_url": "https://api.github.com/orgs/k8smeetup/public_members{/member}", "avatar_url": "https://avatars.githubusercontent.com/u/30145889?v=4", "description": "" },..... 省略其他 organization 信息 ...... { "login": "opensource-f2f", "id": 91397969, "node_id": "MDEyOk9yZ2FuaXphdGlvbjkxMzk3OTY5", "url": "https://api.github.com/orgs/opensource-f2f", "repos_url": "https://api.github.com/orgs/opensource-f2f/repos", "events_url": "https://api.github.com/orgs/opensource-f2f/events", "hooks_url": "https://api.github.com/orgs/opensource-f2f/hooks", "issues_url": "https://api.github.com/orgs/opensource-f2f/issues", "members_url": "https://api.github.com/orgs/opensource-f2f/members{/member}", "public_members_url": "https://api.github.com/orgs/opensource-f2f/public_members{/member}", "avatar_url": "https://avatars.githubusercontent.com/u/91397969?v=4", "description": "" }]
复制代码
可以在返回值中看到 organization opensource-f2f 的 ID 为 91397969。接下来 list 此 organization 下的 repo。
获取 Organization 下的 Repo 信息
用如下命令 list 出 organization opensource-f2f 下的 Repo 信息：
$ curl -i -H "Authorization: token your-github-personal-access-token" \ https://api.github.com/orgs/opensource-f2f/repos
复制代码
返回值为：
[ { "id": 410418183, "node_id": "R_kgDOGHZ8Bw", "name": "artwork", "full_name": "opensource-f2f/artwork", "private": false, "owner": { "login": "opensource-f2f", "id": 91397969, "node_id": "MDEyOk9yZ2FuaXphdGlvbjkxMzk3OTY5", "avatar_url": "https://avatars.githubusercontent.com/u/91397969?v=4", "gravatar_id": "", "url": "https://api.github.com/users/opensource-f2f", "html_url": "https://github.com/opensource-f2f", "followers_url": "https://api.github.com/users/opensource-f2f/followers", "following_url": "https://api.github.com/users/opensource-f2f/following{/other_user}", "gists_url": "https://api.github.com/users/opensource-f2f/gists{/gist_id}", "starred_url": "https://api.github.com/users/opensource-f2f/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/opensource-f2f/subscriptions", "organizations_url": "https://api.github.com/users/opensource-f2f/orgs", "repos_url": "https://api.github.com/users/opensource-f2f/repos", "events_url": "https://api.github.com/users/opensource-f2f/events{/privacy}", "received_events_url": "https://api.github.com/users/opensource-f2f/received_events", "type": "Organization", "site_admin": false }......太长了，忽略其他信息...... }, { "id": 410540405, "node_id": "R_kgDOGHhZdQ", "name": "episode", "full_name": "opensource-f2f/episode", "private": false, "owner": { "login": "opensource-f2f", "id": 91397969, "node_id": "MDEyOk9yZ2FuaXphdGlvbjkxMzk3OTY5", "avatar_url": "https://avatars.githubusercontent.com/u/91397969?v=4", "gravatar_id": "", "url": "https://api.github.com/users/opensource-f2f", "html_url": "https://github.com/opensource-f2f", "followers_url": "https://api.github.com/users/opensource-f2f/followers", "following_url": "https://api.github.com/users/opensource-f2f/following{/other_user}", "gists_url": "https://api.github.com/users/opensource-f2f/gists{/gist_id}", "starred_url": "https://api.github.com/users/opensource-f2f/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/opensource-f2f/subscriptions", "organizations_url": "https://api.github.com/users/opensource-f2f/orgs", "repos_url": "https://api.github.com/users/opensource-f2f/repos", "events_url": "https://api.github.com/users/opensource-f2f/events{/privacy}", "received_events_url": "https://api.github.com/users/opensource-f2f/received_events", "type": "Organization", "site_admin": false }......太长了，忽略其他信息...... }, { "id": 410542067, "node_id": "R_kgDOGHhf8w", "name": ".github", "full_name": "opensource-f2f/.github", "private": false, "owner": { "login": "opensource-f2f", "id": 91397969, "node_id": "MDEyOk9yZ2FuaXphdGlvbjkxMzk3OTY5", "avatar_url": "https://avatars.githubusercontent.com/u/91397969?v=4", "gravatar_id": "", "url": "https://api.github.com/users/opensource-f2f", "html_url": "https://github.com/opensource-f2f", "followers_url": "https://api.github.com/users/opensource-f2f/followers", "following_url": "https://api.github.com/users/opensource-f2f/following{/other_user}", "gists_url": "https://api.github.com/users/opensource-f2f/gists{/gist_id}", "starred_url": "https://api.github.com/users/opensource-f2f/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/opensource-f2f/subscriptions", "organizations_url": "https://api.github.com/users/opensource-f2f/orgs", "repos_url": "https://api.github.com/users/opensource-f2f/repos", "events_url": "https://api.github.com/users/opensource-f2f/events{/privacy}", "received_events_url": "https://api.github.com/users/opensource-f2f/received_events", "type": "Organization", "site_admin": false }, "license": { "key": "apache-2.0", "name": "Apache License 2.0", "spdx_id": "Apache-2.0", "url": "https://api.github.com/licenses/apache-2.0", "node_id": "MDc6TGljZW5zZTI=" }, "allow_forking": true, "is_template": false, "topics": [
], "visibility": "public", "forks": 0, "open_issues": 0, "watchers": 0, "default_branch": "master", "permissions": { "admin": true, "maintain": true, "push": true, "triage": true, "pull": true } }]
复制代码
从返回值可以看到，organization opensource-f2f 下面有三个 Repo，ID 分别为 410418183(artwork Repo)，410540405（episode Repo），410542067（.github Repo）。这些 ID 在后面导入的时候要用到。
获取 Organization 下的 team 信息
用如下命令 list 出 organization opensource-f2f 下面的 teams：
$ curl -i -H "Authorization: token your-github-personal-access-token" \ https://api.github.com/orgs/opensource-f2f/teams
复制代码
返回值为：
[ { "name": "admin", "id": 5157920, "node_id": "T_kwDOBXKfUc4ATrQg", "slug": "admin", "description": "", "privacy": "closed", "url": "https://api.github.com/organizations/91397969/team/5157920", "html_url": "https://github.com/orgs/opensource-f2f/teams/admin", "members_url": "https://api.github.com/organizations/91397969/team/5157920/members{/member}", "repositories_url": "https://api.github.com/organizations/91397969/team/5157920/repos", "permission": "pull", "parent": null }, { "name": "guest", "id": 5158284, "node_id": "T_kwDOBXKfUc4ATrWM", "slug": "guest", "description": "The guests of the open-source talk", "privacy": "closed", "url": "https://api.github.com/organizations/91397969/team/5158284", "html_url": "https://github.com/orgs/opensource-f2f/teams/guest", "members_url": "https://api.github.com/organizations/91397969/team/5158284/members{/member}", "repositories_url": "https://api.github.com/organizations/91397969/team/5158284/repos", "permission": "pull", "parent": null }]
复制代码
可以看到有两个 team：admin 和 guest。ID 分别为 5157920 和 5158284。
获取 Organization team 下面的 user 信息
用如下命令 list organization pensource-f2f 下面 admin team 下的 user：
$ curl -i -H "Authorization: token your-github-personal-access-token" \ https://api.github.com/orgs/opensource-f2f/teams/admin/members
复制代码
返回值如下：
[ { "login": "LinuxSuRen", "id": 1450685, "node_id": "MDQ6VXNlcjE0NTA2ODU=", "avatar_url": "https://avatars.githubusercontent.com/u/1450685?u=9ebd4373578a82540f97f204317df40a852265af&v=4", "gravatar_id": "", "url": "https://api.github.com/users/LinuxSuRen", "html_url": "https://github.com/LinuxSuRen", "followers_url": "https://api.github.com/users/LinuxSuRen/followers", "following_url": "https://api.github.com/users/LinuxSuRen/following{/other_user}", "gists_url": "https://api.github.com/users/LinuxSuRen/gists{/gist_id}", "starred_url": "https://api.github.com/users/LinuxSuRen/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/LinuxSuRen/subscriptions", "organizations_url": "https://api.github.com/users/LinuxSuRen/orgs", "repos_url": "https://api.github.com/users/LinuxSuRen/repos", "events_url": "https://api.github.com/users/LinuxSuRen/events{/privacy}", "received_events_url": "https://api.github.com/users/LinuxSuRen/received_events", "type": "User", "site_admin": false }, { "login": "wey-gu", "id": 1651790, "node_id": "MDQ6VXNlcjE2NTE3OTA=", "avatar_url": "https://avatars.githubusercontent.com/u/1651790?u=5a5ea37c495f7787f35172f0f86569daf5a5a65e&v=4", "gravatar_id": "", "url": "https://api.github.com/users/wey-gu", "html_url": "https://github.com/wey-gu", "followers_url": "https://api.github.com/users/wey-gu/followers", "following_url": "https://api.github.com/users/wey-gu/following{/other_user}", "gists_url": "https://api.github.com/users/wey-gu/gists{/gist_id}", "starred_url": "https://api.github.com/users/wey-gu/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/wey-gu/subscriptions", "organizations_url": "https://api.github.com/users/wey-gu/orgs", "repos_url": "https://api.github.com/users/wey-gu/repos", "events_url": "https://api.github.com/users/wey-gu/events{/privacy}", "received_events_url": "https://api.github.com/users/wey-gu/received_events", "type": "User", "site_admin": false }, { "login": "majinghe", "id": 42570491, "node_id": "MDQ6VXNlcjQyNTcwNDkx", "avatar_url": "https://avatars.githubusercontent.com/u/42570491?u=6d018892fca0c602704d6b46b6bd7ca4966c7009&v=4", "gravatar_id": "", "url": "https://api.github.com/users/majinghe", "html_url": "https://github.com/majinghe", "followers_url": "https://api.github.com/users/majinghe/followers", "following_url": "https://api.github.com/users/majinghe/following{/other_user}", "gists_url": "https://api.github.com/users/majinghe/gists{/gist_id}", "starred_url": "https://api.github.com/users/majinghe/starred{/owner}{/repo}", "subscriptions_url": "https://api.github.com/users/majinghe/subscriptions", "organizations_url": "https://api.github.com/users/majinghe/orgs", "repos_url": "https://api.github.com/users/majinghe/repos", "events_url": "https://api.github.com/users/majinghe/events{/privacy}", "received_events_url": "https://api.github.com/users/majinghe/received_events", "type": "User", "site_admin": false }]
复制代码
可以看到该 team 下面有三个 user 并显示了详细信息。
将 user 导入极狐 GitLab
将上述 list 出的 user 信息作信息匹配（如果需要，比如为了方便识别用户，确定对应用户的 email 等），然后可以将用户加入到极狐 GitLab 中。可以找 Admin 人员在极狐 GitLab 界面上添加 user，也可以利用下面的 API 直接调用 API 添加。不管是哪种方法，都需要确定有 Admin 权限或者找 Admin 人员完成。
$ curl --request POST --header "PRIVATE-TOKEN: jh-gitlab-personal-acess-token" \ "https://your-jh-gitlab-url/api/v4/users?email=devops008@sina.com&password=user-pasword&username=username&name=name"
复制代码
返回值为：
{ "id": 4, "username": "xiaomage", "name": "xiaomage", "state": "active", "avatar_url": "https://secure.gravatar.com/avatar/784477b59c09d7731bd613f1c9a5555a?s=80&d=identicon", "web_url": "https://your-jh-gitlab-url/xiaomage", "created_at": "2021-12-30T07:44:24.241Z", ...... 太长，删除其他信息......}
复制代码
可以看到 user 添加成功，ID 为 4，username 和 name 都是 xiaomage。可以在极狐 GitLab 界面上看到：
可以用如上方法将 user 都导入极狐 GitLab。
将项目导入极狐 GitLab
由于极狐 GitLab 里面是用 Group 来对项目做管理，先创建一个 Group：
$ curl --request POST \--url "https://gitlab.cn/api/v4/groups" \--header "PRIVATE-TOKEN: jh-personal-access-token" \--header "Content-Type: application/json" \--data '{"name": "opensource-f2f", "path": "opensource-f2f", "description": "Create Group using API" }'
复制代码
返回值如下：
{ "id":4948, "web_url":"https://gitlab.cn/groups/opensource-f2f", "name":"opensource-f2f", "path":"opensource-f2f", "description":"Create Group using API",......太长，省略其他信息......}
复制代码
名为 opensource-f2f 的 Group 已经创建起来了，在极狐 GitLab 实例界面上可以看到：
接下来，将 user 添加到 Group 中，可以在极狐 GitLab 界面上，直接添加：
也可以用如下的 API 进行添加：
$ curl --request POST --header "PRIVATE-TOKEN: jh-personal-access-token" \ --data "user_id=user-id&access_level=30" "https://gitlab.cn/api/v4/groups/your-group-id/members"
复制代码
将需要添加的 user 的 user-id 以及极狐 GitLab token、目的 Group 替换完毕，执行命令即可。可在极狐 GitLab 界面上，看到新增了一个用户：
最后导入 GitHub Repo，比如 ID 为 410540405 的 episode：
$ curl --request POST \ --url "https://gitlab.cn/api/v4/import/github" \ --header "content-type: application/json" \ --header "PRIVATE-TOKEN: your-jh-personal-access-token" \ --data '{ "personal_access_token": "your-github-personal-access-token", "repo_id": "410540405", "target_namespace": "opensource-f2f", "new_name": "jh-episode"}'
复制代码
返回值如下：
{ "id":13544, "name":"jh-episode", "full_path":"/opensource-f2f/jh-episode", "full_name":"opensource-f2f / jh-episode"}
复制代码
在极狐 GitLab 界面查看导入的项目：
接下来可以根据需要，给此项目添加 user，方法和给 Group 添加 user 的类似。可以将其他 GitHub 如法炮制般的全部迁移到极狐 GitLab 下面，开启极狐 GitLab 之旅。
评论