本地已有库批量迁移

一、前提条件

操作前，请确认工具已安装并运行正常，参见安装本地迁移工具。

二、迁移准备

本工具可以帮助你进行本地代码库Git数据的批量迁移，包括源代码、分支、提交、标签信息。

1. 在正式迁移生产库前，建议使用非正式库进行试迁移，保障配置正确后正式迁移。

2. 在迁移操作时建议控制本地代码库的库变更和写入行为，一旦仓库迁移成功后，重复迁移不会刷新变更的代码数据，即本地库的新增内容不会更新至Codeup。

三、定义迁移配置文件

1. 现在我们开始迁移，请输入以下命令，初始化本次迁移所需的配置文件如下：

   ./codeup-cli init

   此时可以看到配置文件初始化成功的提示。

   demo:workspace my$ ./codeup-cli init
   【提示】 配置文件路径：/Users/my/config.yaml
   【成功】 初始化 config.yaml 成功，路径地址为：/Users/my/config.yaml，请按照帮助文档正确填写配置。

2. 接着根据提示的路径，打开这个config.yaml文件，开始填写源和目标平台的配置参数，用于代码库拉取和导入。

   配置文件字段说明，本地已有仓库迁移在config.yaml模板中的source - 源平台参数配置仅需填写 platform字段，其他字段请自行删除。

   source - 源平台参数配置	是否必填	参数说明
   platform	必填	请填写 "local"。
   apiEndpoint	暂无	系统预留字段。
   host	暂无	系统预留字段。
   accessToken	暂无	系统预留字段。
   username/password	暂无	系统预留字段。
   accessKey	暂无	系统预留字段。
   secretKey	暂无	系统预留字段。
   orgID	暂无	系统预留字段。
   localSSHKeyPath	暂无	系统预留字段。
   asMember	暂无	系统预留字段。

   target - 目标平台参数配置	是否必填	参数说明
   platform	必填	codeup （初始化已配置，请勿修改）。
   apiEndpoint	必填	devops.cn-hangzhou.aliyuncs.com（初始化已配置，请勿修改）。
   host	必填	codeup.aliyun.com（初始化已配置，请勿修改）。
   accessToken	必填	阿里云主账号在 Codeup 的个人访问令牌，需勾选授予权限 write:repo。
   username	HTTP克隆必填	Codeup 可用于HTTP克隆的用户名。
   password	HTTP克隆必填	Codeup 可用于HTTP克隆的密码。
   accessKey	必填	阿里云的主账号（同时需要作为Codeup目标企业的拥有者）AK （AccessKey ID）参见如何获取。
   secretKey	必填	阿里云的主账号（同时需要作为Codeup目标企业的拥有者）SK（AccessKey Secret）参见如何获取。
   orgID	必填	期望迁移到的 Codeup 企业ID，可在云效企业管理后台查看。
   localSSHKeyPath	SSH克隆必填	Codeup 已配置的 SSH key 对应的本地私钥 key 路径，注意需填写完整路径，如 /Users/my/.ssh/id_rsa。 具体路径请根据实际本机私钥存放路径填写。

   以SSH方式为例，简化的配置文件内容如下：

   import:
       source:
           platform: local
       target:
           platform: codeup
           apiEndpoint: devops.cn-hangzhou.aliyuncs.com
           accessToken: xxxxx
           host: codeup.aliyun.com
           accessKey: xxxxx
           secretKey: xxxxx
           orgID: xxxxx
           localSSHKeyPath: /Users/my/.ssh/id_rsa
       # projectlistpath 指定步骤四里迁移库范围文件路径；
       projectlistpath: projects.csv    
       # workdir 指定迁移的工作目录路径，迁移完成后将自动清理目录；
       workdir: /Users/my/workspace  

四、定义迁移代码库范围

您需要告知迁移工具要迁移的代码库列表范围，这需要一个配置文件。

可以通过以下命令，生成迁移库范围的配置文件，文件需要和步骤三中 projectlistpath 指定路径一致：

./codeup-cli import --gen project

命令执行完成后会在当前目录下生成一个projects.csv的配置文件，打开文件，其内容格式是每一行都是[本地仓库绝对路径]，[Codeup代码库相对路径]，[Codeup代码库可见性]，示例如下：

#本地仓库绝对路径,Codeup代码库相对路径,Codeup代码库可见性
/Users/my/Downloads/groupname/demo,groupname/demo,10

至此，您明确了迁移的代码库范围。

五、执行迁移

即将完成迁移，请确认目前工作目录下2个配置文件（迁移配置文件、代码库范围文件）和存放代码库的文件夹（例如自定义的“repo”）已准备完毕：

通过以下命令启动执行迁移：

./codeup-cli import --run true 
 # 迁移过程中会展示迁移的细节，如果有问题会显示报错信息

工具执行完后，如果一切正常，您便可以前往Codeup企业查看已迁移的代码库信息，确认迁移无误。

迁移过程中遇到无法处理的问题，请添加钉钉群咨询技术支持：32027065。