安装迁移工具

迁移对象

• 自建Gitlab代码库：支持迁移Git代码数据、人员权限、Webhooks、保护分支、开启的合并请求。

• 常见第三方平台代码库的Git代码数据，如Gitee、Coding、Github等。

• 本地已存在的代码库。

操作步骤

• 步骤一：下载工具

• 步骤二：安装工具

• 步骤三：测试验证

• 步骤四：场景选择

• 步骤五：相关步骤（可选）

步骤一：下载工具

请根据自身系统选择下载迁移工具：

步骤二：安装工具

Codeup-CLI工具下载后可直接使用，请将已下载解压的工具按以下指引放置到命令行执行的目录下即可：

# 建议本地新建一个工作空间，名称可自定义，如”workspace“，迁移完成后可自行删除：
mkdir workspace
cd workspace

# 把下载的codeup-cli工具放至您实际的空间目录下
cp ~/Downloads/codeup-cli ./

# 新建一个目录用于存放第三方需要迁移的代码库，名称可自定义，如”repo“
mkdir repo

步骤三：测试验证

以Linux为例，在命令行执行以下命令，确认工具运行正常：

./codeup-cli --help

异常提示处理：

• 若出现运行工具权限不足相关报错提示，Linux/Mac请执行以下命令授权。

  chmod +x ./codeup-cli

• 若出现以下提示，表明下载的工具包和你的系统类型不匹配，请确认系统类型后重新下载对应工具包。

  Bad CPU type in executable

步骤四：场景选择

如上述验证工具运行正常，可根据您的期望结合平台类型选择适合的迁移场景：

• 自建Gitlab迁移。

• 通用三方代码平台迁移（如 GitHub、Gitee、Coding、Teambition）。

• 本地已有库批量迁移。

步骤五：相关步骤（可选）

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

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

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

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

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

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

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

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

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