共用方式為


傳統管線中的工作組

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

在傳統管線中,工作組會將管線中已定義的工作序列封裝成單一可重複使用的工作。 新的工作組會自動新增至工作目錄,而且可以像其他工作一樣新增至專案中的管線。 工作組會儲存在專案層級,而且無法在專案範圍之外存取。

工作群組可讓您將所有應用程式的部署步驟標準化並集中管理。 當您集中變更工作組時,變更會自動反映在使用工作組的所有管線定義中。 您不需要個別變更每個定義。

注意

YAML 管線中不支援工作組。 相反地,您可以使用 範本

必要條件

  • 您有權建立管線的 Azure DevOps 組織和專案。
  • 在專案中建立的傳統管線。

將工作參數擷取為變數

當您建立工作組時,您可以選擇從封裝的工作擷取參數做為組態變數,並擷取其餘的工作資訊。 工作中使用的變數會自動擷取並轉換成工作組的參數,而且這些組態變數的值會轉換成工作組的預設值。

您也可以在儲存新的工作組時變更參數的預設值。 當您將管線執行或發行排入佇列時,會擷取封裝的工作,並將您為工作組參數輸入的值套用至工作。

在建立工作組之前,請務必定義您想要能夠在管線執行中設定的任何參數,例如 $(MyVariable)。 沒有任何值或具有指定值,而不是變數的任何工作參數都會變成固定參數,而且不會公開給工作組做為可設定的參數。

您也可以在工作組中設定工作條件,例如只有在 PowerShell 腳本工作上一個工作失敗時才執行此工作,而且這些條件會與工作組一起保存。

注意

傳統管線和傳統發行管線支援工作組。

建立工作群組

當您儲存新的工作組時,您會提供名稱和描述,並選取工作目錄中工作組的類別。

  1. 開啟您要在其中建立新工作組的管線。

  2. 若要確保您想要包含的任何工作都不包含任何連結的參數,請在管線設定面板中選取 [全部取消連結 ],然後選取 [ 確認]。

    顯示所有工作取消連結參數的螢幕快照。

  3. 選取您想要變成工作組的管線工作順序,以滑鼠右鍵按兩下以開啟操作功能表,然後選擇 [ 建立工作組]。

    顯示從工作發行管線清單建立工作組的螢幕快照。

  4. 指定新工作組的名稱和描述,以及您要新增至之工作窗格中的類別

  5. 選取 建立。 系統會建立新的工作組,並取代管線中選取的工作。

  6. '$(vars)'除了預先定義的變數之外,基礎工作的所有 都會呈現為新建立工作組的必要參數,並視需要編輯值。

    例如,如果您有不想參數化的工作輸入,工作輸入 foobar 會轉換成工作組參數 'foobar'。 您可以提供工作組參數'foobar'$(foobar)的預設值,以確保在運行時間,展開的工作會取得您想要的輸入。

  7. 儲存更新的管線。

管理工作組

目前專案中的所有工作組都會列在 [工作組] 頁面上的 [管線] 底下

顯示列出工作組的螢幕快照。

在 [工作組] 頁面頂端,您可以選取 [匯入] 以匯入先前儲存的工作組定義。 您可以使用此功能在專案與企業之間傳送工作組,或復寫和儲存工作組的複本。

您也可以選取 頁面頂端的 [安全性 ],以定義誰可以使用、編輯、刪除或設定專案中所有工作組的許可權。

若要管理工作組,請以滑鼠右鍵按下或選取群組的 [更多動作 ] 圖示,然後從操作功能表中選取下列其中一個選項:

  • 選取 [ 刪除 ] 以刪除工作組,然後在確認畫面上再次選取 [ 刪除 ]。
  • 選取 [ 匯出 ] 以將工作組的複本儲存為 JSON 管線。
  • 選取 [安全性 ] 以定義誰可以使用、編輯、刪除或設定工作組的許可權。

若要開啟要編輯的工作組詳細數據頁面,請選取 [工作組] 頁面上的工作組名稱

顯示管理工作組的螢幕快照。

  • 在 [ 工作] 索引標籤上,您可以編輯組成工作組的工作。 針對每個封裝的工作,您可以變更不可變數參數的參數值、編輯現有的參數變數,或將參數值轉換成變數。 當您儲存變更時,所有使用工作組的定義都會挑選變更。

    工作組的所有變數參數都會在管線定義中顯示為必要參數。 您也可以設定工作組參數的預設值。

  • 在 [ 歷程記錄] 索引標籤上,您可以看到群組變更的歷程記錄。

  • 在 [ 參考] 索引標籤上,您可以看到參考此工作組之所有管線和其他工作組的清單。 此清單可協助您確保變更不會對其他進程產生非預期的影響。

建立工作群組的預覽和更新版本

所有內建的 Azure Pipelines 工作都會 建立版本。 版本控制可讓管線在開發、測試及發行新版本時繼續使用現有的工作版本。 您可以使用相同的方式來設定自定義工作組的版本,以提供相同的優點。

  1. 若要建立工作組的版本,請在完成編輯之後,選取 [另存新檔],而不是 [儲存]。

    顯示將草稿更新儲存至工作組的螢幕快照。

  2. 字串 -test 會附加至工作組版本號碼。 當您對變更感到滿意時,請選擇 [ 發佈草稿]。 在 [ 發佈草稿] 工作組 畫面上,如果您想要將新版本發佈為預覽,請選取 [發佈為預覽 ],然後選取 [ 發佈]。

    顯示發佈工作組草稿版本的螢幕快照。

  3. 您現在可以在發行程式中使用更新的工作群組。 您可以在已使用工作組的管線中變更版本號碼,或從 [新增工作 ] 窗格中選擇已建立版本的工作組。 如同內建工作,當您新增工作組時,預設值是最高的非預覽版本。

    顯示使用工作組草稿版本的螢幕快照。

  4. 完成測試更新的工作組之後,請選擇 [ 發佈預覽],然後選取 [ 發佈]。 預覽字串會從版本號碼中移除,而版本現在會顯示在定義中為生產就緒版本。

    顯示發佈工作組預覽版本的螢幕快照。

  5. 您現在可以在已包含工作組的管線中選取新的生產就緒版本。 當您從 [新增工作 ] 面板新增工作組時,會自動選取新的生產就緒版本。 您可以編輯管線以使用舊版。

    顯示使用工作群組更新版本的螢幕快照。

使用工作組版本

工作組更新可以是次要或主要版本更新。

建立次要版本更新

若要建立次要版本更新,您可以在編輯后直接儲存工作組,而不是將它儲存為草稿。

版本號碼不會變更,而且管線定義中會自動顯示最新的變更。 例如,如果您的工作組是版本 1,您可以有任意數目的次要版本更新,例如 1.11.21.3。 在您的管線中,工作組版本會顯示為 1.*

當您預期管線使用新變更而不變更管線定義中的版本號碼時,請針對工作組中的小型變更使用次要版本更新。

建立主要版本更新

若要建立新的主要版本,您可以將工作組更新儲存為草稿並建立預覽、驗證變更,然後發佈預覽。

此程式會將工作組提高到新版本。 如果您有一個具有版本 1.*的工作群組,則新版本會發佈為 2.*3.*4.*等。

有關新版本可用性的通知會出現在使用工作組的所有管線定義中。 如果使用者想要在管線中使用,則必須明確地更新為新的工作組版本。

當您進行可能會中斷現有管線的大量變更時,您可以將變更測試並推出為新的主要版本。 用戶可以選擇升級至新版本,或保留目前的版本。 這項功能與一般工作版本更新相同。

測試次要版本更新

如果您的工作組更新不是重大變更,但您想要先測試,然後強制所有管線使用最新的變更,請遵循下列步驟:

  1. 將工作組變更儲存為草稿。 系統會使用您的變更來建立名為 <Taskgroupname> (Draft) 的新草稿工作組。
  2. 將此草稿工作組直接新增至測試管線。
  3. 驗證測試管線中的變更。 一旦您對變更有信心,請返回您的主要工作組,執行相同的變更,並直接儲存。 變更會儲存為次要版本更新。
  4. 新的變更現在會顯示在使用此工作組的所有管線中。 現在您可以刪除草稿工作組。

說明與支援