共用方式為

將傳統管線遷移至 YAML

  • 發行項

Azure DevOps Services

藉由將現有的傳統管線轉換為使用 YAML，開始使用 Azure Pipelines。 透過 YAML 型管線，您可以實作 CI/CD 策略作為程式碼，並查看其歷程記錄、比較版本、指責、批注等等。

當您轉換傳統管線時，最終產品是兩個管線。 您將有一個新的 YAML 管線和可淘汰的傳統管線。 傳統管線的執行歷程記錄會保留在傳統管線中。

必要條件

開始之前，請確定您有下列專案。

  • 具有有效訂用帳戶的 Azure 帳戶。 免費建立帳戶。
  • 作用中的 Azure DevOps 組織。 註冊 Azure Pipelines。
  • 使用傳統使用者介面 （UI） 編輯器的工作管線。
  • 程序代碼中的範例 YAML 管線檔案。 在下一節中建立範例 YAML 管線。

建立範例 YAML 管線

執行下列步驟來建立範例 YAML 管線，您稍後會使用從傳統 UI 編輯器導出的程式碼進行更新。

  1. 登入您的組織 （https://dev.azure.com/{yourorganization}） 並選取您的專案。

  2. 選取 [管線]，然後選取 [新增管線]。

    要選取以建立新管線的兩個按鈕。

  3. 選取原始程式碼的位置作為 GitHub 或 Azure Repos Git。

    原始碼的可能選取項目清單。

  4. 選取存放庫。

    您為原始碼管線選取存放庫的頁面。

  5. 在 [設定管線] 頁面上，選取 [ 入門管線]。

    用來設定新管線的範本清單。

  6. 選取儲存並執行。

    檢閱您選取 [儲存並執行] 的頁面。

  7. 輸入您的認可訊息，選取 [直接認可至主要分支]，然後選擇 [ 儲存並再次執行 ]。 新的回合隨即啟動，並認可至存放庫。 等待執行完畢。

    認可訊息以認可至主要分支，然後選取 [儲存並執行] 按鈕。

匯出傳統管線

執行下列步驟，將傳統管線匯出至您可以在編輯器中使用的 YAML 檔案。

  1. 移至 [Pipelines]>[管線]。

  2. 在傳統組建設計工具中開啟您的傳統管線。

  3. 選取省略號 （...），然後選取 [導出至 YAML]。

    操作功能表的螢幕快照，可將管線導出至YAML。

  4. 在程式代碼編輯器中開啟下載的 YAML 檔案。

  5. 如果您的 YAML 管線包含傳統 UI 中定義的變數，請在管線設定 UI 或 YAML 檔案中再次定義變數。 如需詳細資訊，請參閱 定義變數。

  6. cron檢閱 YAML 檔案中的任何排程。 根據預設， cron YAML 中的排程是 UTC。 在傳統管線中，它們位於組織的時區。 如需詳細資訊，請參閱 設定管線的排程。

  7. 使用任務助理對 YAML 檔案進行任何其他變更。 任務助理是畫面右側的窗格，可協助您正確建立和修改 YAML 步驟。

    使用任務助理設定您的管線工作。

  8. 儲存並執行 管線。

清除資源

如果您不再使用此範例管線，請從專案中刪除它。 刪除是永久的，且包含所有組建和相關聯的成品。

  1. 選取省略號 [...]，然後選取 [ 刪除]。

  2. 輸入管線的名稱以永久刪除它，然後選取 [ 刪除]。

常見問題集

YAML 管線中是否有工作在發生建置失敗時建立工作專案？

YAML 管線在失敗設定上沒有建立工作專案，例如傳統建置管線。 您有數個選項可以自行建立這項功能。

下一步

瞭解 YAML 與傳統管線之間的功能差異。

使用 Azure Pipelines