前言

從這篇文章開始，我們將介紹專案 (Project) 架構與如何將專案內想要的設定做搬移動作。對於一般使用者或中小企業，很難想像有大規模搬移的行為，也因為沒有搬移的需求，在使用上就沒有特別的習慣，但對於大量使用者的平台管理者而言，宣導良好的使用習慣是很重要的事情，避免因為搬移耗時費力，又有停機的風險。這系列幾篇我們將分享 Wiki、Board、Repos、Pipeline 搬移至另一個 Project 方法與如何維持良好的使用習慣。

Azure DevOps 專案架構

過去在擔任微軟認證講師期間，到企業授課時比較喜歡將 Azure DevOps 初階課程分成四個部分介紹，包含組織/專案設定、Board(專案管理)、Repos(程式碼開發) 與 Pipeline (CI/CD功能)，進階課程兩個部分為 Azure Artifact 與 Test Plan。其中組織與專案架構，一個 Azure DevOps 底下可以有多組織，一個組織可以有多個 Project，一個 Project 有多個 Team，如下圖所示：

功能搬移主要有 Wiki 搬移、專案管理與工作事項版移、Repos 搬移與 Pipeline 搬移。其中有些功能可以透過 Git 功能搬移，有些功能可以透過 Azure DevOps Portal 上 UI 操作進行搬移，有些功能可以透過 Azure DevOps API 進行搬移。無論透過哪種功能，要注意到可能的相依，避免錯誤的順序導致需要重新設定或無法使用。

常見問題

1. 搬移會不會只有部份成功與部分失敗，搬移錯的內容或不小心搬移到錯誤的地方怎麼辦？
   答：搬移功能只有成功與失敗，不會有搬移一半的情況發生；另外如果搬移錯的或搬移到錯的地方時候，只需要將目標位置已經搬移內容刪除即可。

2. 會不會搬移到同組織不同團隊的專案或內容？
   答：在權限分明的組織內，使用者是看不見沒有權限的專案與其功能。理所當然，無論透過 Git、UI 介面或 Azure DevOps API，搬移自己沒權限的內容，一樣會出現未授權錯誤出現，所以不用擔心這件事情。

3. 有沒有現成的工具可以使用？
   可以參考下列連結，但工具使用不在此系列文章，我們將說明比較底層的方式
   Marketplace https://aka.ms/DevOpsLab/migrationtools
   GitHub Repo https://aka.ms/DevOpsLab/GitHubRepo
   Migration documentation https://aka.ms/DevOpsLab/MigrationDocs