一、前提條件

操作前，請確認工具已安裝并運行正常，參見安裝本地遷移工具。

二、遷移準備

本工具可以幫助您進行三方代碼庫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 文件，開始填寫源和目標平臺的配置參數，用于代碼庫拉取和導入。

   配置文件字段說明，請填寫必填的字段，其中 HTTP 或 SSH 克隆二選一填寫，不需要的字段請自行刪除：

   source - 源平臺參數配置	是否必填	參數說明
   platform	必填	請填寫 "common"。
   apiEndpoint	暫無	系統預留字段。
   host	暫無	系統預留字段。
   accessToken	暫無	系統預留字段。
   username	如用HTTP克隆必填	三方平臺可用于HTTP克隆的用戶名。
   password	如用HTTP克隆必填	三方平臺可用于HTTP克隆的密碼。 *注意GitHub需要用戶名/Token，已不支持使用登錄密碼。
   accessKey	暫無	系統預留字段。
   secretKey	暫無	系統預留字段。
   orgID	暫無	系統預留字段。
   localSSHKeyPath	如用SSH克隆必填	三方平臺已配置的 SSH key 對應的本地私鑰 key 路徑，注意填寫完整路徑，如 /Users/my/.ssh/id_rsa。 具體路徑請根據實際本機私鑰存放路徑填寫。
   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: common
           localSSHKeyPath: /Users/my/.ssh/id_rsa
       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代碼庫可見性]，示例如下：

#GitHub代碼庫完整路徑,Codeup代碼庫相對路徑,Codeup代碼庫可見性
https://github.com/namesapce/demo.git,namesapce/demo,10

#Gitee代碼庫完整路徑,Codeup代碼庫相對路徑,Codeup代碼庫可見性
https://gitee.com/namesapce/demo.git,namesapce/demo,10 

#Coding代碼庫完整路徑,Codeup代碼庫相對路徑,Codeup代碼庫可見性
https://e.coding.net/namesapce/demo.git,namesapce/demo,10 

#Teambition代碼庫完整路徑,Codeup代碼庫相對路徑,Codeup代碼庫可見性
https://codeup.teambition.com/namesapce/demo.git,namesapce/demo,10 

至此，您明確了遷移的代碼庫范圍。

五、執行遷移

即將完成遷移，請您確認目前工作目錄下2個配置文件（遷移配置文件、代碼庫范圍文件）和存放代碼庫的文件夾（例如自定義的“repo”）是否已準備完畢：

通過以下命令啟動執行遷移：

./codeup-cli import --run true 
 # 遷移過程中會展示遷移的細節，如果有問題會顯示報錯信息

工具執行完后，如果一切正常，您便可以前往Codeup企業查看已遷移的代碼庫信息，確認遷移無誤。

遷移過程中遇到無法處理的問題，請添加釘釘群咨詢技術支持：32027065。