文档

安装本地迁移工具

更新时间:

本地迁移工具 Codeup-CLI 支持三方代码库数据批量导入,降低三方数据迁移成本。

Codeup-CLI 工具使用方法

简单四步,完成代码批量迁移:

  • 步骤一.根据自身系统下载迁移工具;

  • 步骤二.生成迁移源和目标的配置文件,并完成参数配置;

  • 步骤三.生成期望导入的代码库列表文件;

  • 步骤四.执行迁移命令,工具将依据步骤二、三生成的配置文件将代码数据迁移至 Codeup 指定企业;

目前支持迁移对象包括:

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

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

  • 本地已存在的代码库;

下载工具

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

系统类型

下载地址

macOS ARM 64位

工具下载地址

macOS 64位

工具下载地址

Linux 64位

工具下载地址

Linux 32位

工具下载地址

Windows 64位

工具下载链接

Windows 32位

工具下载链接

安装工具

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

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

# 把 codeup-cli 工具放至该空间下
cp ~/Downloads/codeup-cli ./

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

测试工具

在命令行执行以下命令,确认工具运行正常:

./codeup-cli --help

image

说明

异常提示处理:

  1. 若出现运行工具权限不足相关报错提示,Linux/Mac 请执行以下命令授权:

chmod +x ./codeup-cli
  1. 若出现以下提示,表明下载的工具包和你的系统类型不匹配,请确认系统类型后重新下载对应工具包:

Bad CPU type in executable

执行迁移

如验证工具运行正常,可根据期望导入的三方平台类型进行下一步迁移操作:

后续步骤

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

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

2. 更新代码库地址

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

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

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

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

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