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

背景信息

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

• 自建 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.（可选）解绑三方授权

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