从 GitHub 到极狐GitLab 的迁移指南

极狐(GitLab) 极狐GitLab开发者 2022-05-14

把项目从 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)

极狐(GitLab) 以“核心开放”为原则，面向中国市场，提供开箱即用的开放式一体化安全DevOps平台——极狐GitLab。通过业界领先的优先级管理、安全、风险和合规性功能，实现产品、开发、QA、安全和运维团队间的高效协同，加速和优化企业软件开发生命周期。极狐GitLab由极狐信息技术(湖北)有限公司在国内独立运营，提供中国本地化功能和支持服务。极狐(GitLab)公司以“中外合资3.0”模式创立，公司投资方包括GitLab Inc.、红杉宽带跨境数字产业基金，以及高成资本。

点击“阅读原文”，申请极狐GitLab 30 天旗舰版免费试用

观察｜官方通报陕西蒲城一职校学生坠亡：事发前与舍友发生口角和肢体冲突认定该生系高空坠落死亡

市管干部“龚书记”免职迷局

讣告！又一知名女星在家中去世，终年54岁，曾是无数人白月光…

近视的孩子有救了！国内最新近视防控矫正技术，不手术，扫码进群即可了解！

著名口述史学者Portelli的一部被忽视的口述史作品 | 一个工业小镇的传记：意大利特尔尼（1831-2014）

从 GitHub 到极狐GitLab 的迁移指南

您可能也对以下帖子感兴趣

观察｜官方通报陕西蒲城一职校学生坠亡：事发前与舍友发生口角和肢体冲突 认定该生系高空坠落死亡

市管干部“龚书记”免职迷局

讣告！又一知名女星在家中去世，终年54岁，曾是无数人白月光…

近视的孩子有救了！国内最新近视防控矫正技术，不手术，扫码进群即可了解！

著名口述史学者Portelli的一部被忽视的口述史作品 | 一个工业小镇的传记：意大利特尔尼（1831-2014）

生成图片，分享到微信朋友圈

从 GitHub 到极狐GitLab 的迁移指南

您可能也对以下帖子感兴趣

观察｜官方通报陕西蒲城一职校学生坠亡：事发前与舍友发生口角和肢体冲突认定该生系高空坠落死亡