CTO | 产品迁移 | 汽车 | 医疗 | 互联网 2023-04-13

从GitHub 到极狐GitLab 的迁移指南

小马哥
极狐GitLab DevOps 技术布道师

把项目从 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 即可。下面进行演示。

前提条件

确认需要迁移的项目，本文演示的仓库地址为：https://github.com/majinghe/tekton-demo
获取可用的极狐GitLab 与 GitHub Personal Access Token

极狐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 之旅。

极狐GitLab 一体化DevOps平台专为中国用户研发，免费试用60天专业版高级功能

企业版试用

预约演示

作者

小马哥
极狐GitLab DevOps 技术布道师