通过网页端导入三方代码库

通过网页端导入三方代码库

更新时间:

云效代码管理提供代码库 Git 数据快速导入能力,可以方便地导入托管在三方平台上的代码资源。本文介绍如何在网页端导入三方代码库 Git 数据(不包括成员权限、合并请求等数据)。针对自建 GitLab 整体搬站场景,或自建服务不通公网、 1G 以上超大代码库或上千个大量代码库迁移场景,请通过本地迁移工具导入,参见 安装本地迁移工具

背景信息

云效代码管理支持迁移的三方代码库平台如下:

前提条件

在网页端导入代码库前,你需要准备好目标三方平台的账户访问令牌(Access Token),获取方法参见 Access Token 访问令牌如何获取?

步骤一:选择待导入的三方平台

  1. 登录 Codeup 首页 ,单击右上角 导入代码库

1-11

  1. 选择期望的三方代码托管平台。

1-2

步骤二:配置三方平台的鉴权信息

不同的三方平台需要的鉴权信息不同,请根据以下指引填写对应的参数:

1. 自建 GitLab

1-2

参数说明如下:

① Host URL:自建 GitLab 主页地址

说明

主页地址非代码库完整 URL,请勿输入主页以外的 URL 参数后缀,正确示例: https://gitlab.your-company.com

②:Access Token:自建 GitLab Token 生成方式请参见 Access Token 添加说明

2. 公网 GitLab

1-2

参数说明:公网 GitLab 地址是固定的,仅需要填写 Access Token。公网 GitLab Token 生成方式请参见 Access Token 添加说明

3. 码云

1-2

参数说明:码云 Access Token 生成方式请参见 Access Token 添加说明

4. Coding

1-2

参数说明:Coding Access Token 生成方式请参见 Access Token 添加说明

5. GitHub

1-2

参数说明:GitHub Access Token 生成方式请参见 Access Token 添加说明

6. 通用 URL 导入

1-2

参数说明:

  • URL 导入支持针对通用三方平台按单个代码进行导入,需要填写代码库完整的克隆地址。

说明

注意代码库克隆地址非浏览器中的代码库 URL,即可用于 HTTP 克隆的地址。

  • 账号:可用于第三方平台 HTTP 克隆使用的账号。

  • 根据不同的三方平台,对应 Access Token 生成方式参见 Access Token 添加说明

7. 本地导入工具

当代码库数量超过 100 个,或单个代码库容量超过 1G 时,网页端导入可能出现超时,建议使用本地导入工具进行导入,参见 安装本地迁移工具

步骤三:批量导入代码库

批量导入支持范围:目前针对自建GitLab、GitLab、码云、Coding、GitHub 支持批量代码库导入。

在配置完三方平台鉴权信息后可以进行批量导入,以下用自建 GitLab 为例说明。

  1. 根据步骤二完成鉴权设置后,进入自建 GitLab 待导入代码库列表页面。

注意当前列表仅展示已绑定账号作为成员的代码库,如需作为 GitLab 平台管理员整站迁移所有代码库,请使用本地迁移工具,参见 自建Gitlab迁移

1-2

  1. 单击期望导入的代码库后的 导入 按钮,启动导入。

  2. 等待导入状态变更为“导入成功”,即表示导入成功,可以单击进入库进行查看。

  3. 若导入状态为“导入失败”,请光标指向导入失败的标签稍作悬停,可查看失败原因。

  4. 若代码库路径存在冲突或不合法,请根据对应提示进行修改后导入。

image

导入状态说明

导入任务划分为 未导入、导入中、排队中、导入成功、导入失败 五类。

1-2

导入状态

描述

未导入

针对未导入的代码库可以选择单库或批量进行导入。Codeup 默认按原代码库名称生成库名,如果重名,如①所示,需要手动修改后才能进行②的导入操作。

导入中

代码库开始导入则进入 导入中 状态,此状态允许执行终止导入操作。一旦终止则该代码库进入 导入失败 状态。

排队中

当批量导入时可能出现并行数量限制引起的排队状态,排队中可取消导入操作。一旦取消对应代码库进入 未导入 状态。

导入失败

导入失败的代码库支持重试,点击重试后代码库重新开始导入,进入导入中状态。

导入成功

导入完成后进入 导入成功 状态,可如③所示进入代码库查看。

如需刷新列表查看导入状态,请单击④,刷新操作仅影响未导入的库信息。

后续步骤

1. 云效代码推拉认证设置

当开发者使用云效新平台推拉代码,需要配置认证信息:

2. 更新代码库地址

导入后,代码库地址需要更新为云效上新仓库的地址。

  • 本地代码库 Remote 地址更新:

查看当前配置的remote : 执行 git remote -v
替换当前配置的remote(默认origin):执行 git remote set-url origin <云效上新的 git clone 地址>
  • 三方系统推拉代码库地址更新

如有三方系统推拉代码的场景,需要手动替换三方系统上配置的仓库地址。

如三方系统使用 HTTPS 推拉代码,需要同时更新三方系统上配置的推拉账密参数,使其能够正常访问云效的代码库。云效代码库的 HTTPS 克隆账密配置参见 配置 HTTPS 克隆账号密码

3.仓库代码同步

针对导入后三方代码库持续更新,而需要单向强制覆盖同步的场景,可以使用仓库同步功能,详情参见 仓库同步

4.(可选)解绑三方授权

如果你需要解绑三方库授权,在待导入代码库列表页面,单击解除绑定。

1-2