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

背景信息

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

• 自建 GitLab

• 公网 GitLab（ https://gitlab.com ）

• 码云

• Coding

• GitHub

• 通用 URL 导入

前提条件

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

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

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

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

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

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

1. 自建 GitLab

参数说明如下：

① Host URL：自建 GitLab 的 主页地址 ；

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

2. 公网 GitLab

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

3. 码云

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

4. Coding

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

5. GitHub

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

6. 通用 URL 导入

参数说明：

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

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

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

7. 本地导入工具

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

步骤三：批量导入代码库

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

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

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

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

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

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

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

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

导入状态说明

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

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

后续步骤

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

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

• 如使用 SSH 方式，配置说明参见 配置 SSH 密钥 。

• 如使用 HTTPS 方式，配置说明参见 配置 HTTPS 克隆账号密码 。

2. 更新代码库地址

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

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

查看当前配置的remote : 执行 git remote -v
替换当前配置的remote(默认origin)：执行 git remote set-url origin <云效上新的 git clone 地址>

• 三方系统推拉代码库地址更新

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

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

3.仓库代码同步

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

4.（可选）解绑三方授权

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