背景信息

云效代碼管理支持遷移的三方代碼庫平臺如下：

• 自建 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.（可選）解綁三方授權

如果你需要解綁三方庫授權，在待導入代碼庫列表頁面，單擊解除綁定。