手動驗證工作

Azure DevOps Services |Azure DevOps Server 2020

在 YAML 管線中使用這項工作,在階段中暫停執行,通常是執行一些手動動作或驗證,然後繼續/拒絕執行。

要求

只有在 YAML 管線中才支援這項工作。 只能用在 YAML 管線的 無代理程式作業 中。

引數

參數 註解
instructions 選擇性。 啟動工作時,要向使用者顯示的指示文字。
notifyUsers 選擇性。 使用者的電子郵件地址清單,將會通知該工作已啟用。 只有具有佇列組建許可權的使用者可以採取手動驗證。 您可以使用 [org name]\group name 語法傳送至群組。
onTimeout 選擇性。 如果工作超時,要採取 (拒絕或繼續) 的動作。預設值為 [拒絕]。
控制項選項 請參閱 控制項選項

手動驗證工作可讓您在階段中暫停管線執行,通常是為了執行一些手動步驟或動作,然後繼續執行管線。 例如,使用者可能需要手動驗證特定的部署設定,管線才會啟動長時間執行的大量計算作業。

手動驗證工作設定包括可用來提供相關資訊的指令參數,或指定使用者在暫停期間應執行的手動步驟。 您可以設定工作在使用者和使用者群組等待審核時,傳送電子郵件通知給使用者和使用者群組,並在發生可設定的超時時間之後,指定自動回應 (拒絕或繼續) 。

您可以使用 [控制選項] 中可用的 timeoutInMinutes 參數來指定工作的超時值。 這是選擇性參數。

注意

若要讓工作完全執行,工作的超時值應該高於工作的超時值。 請參閱 預設作業超時值

提示

您可以使用變數來指定參數中的 notifyUsers 電子郵件地址。

當在管線期間啟用手動驗證工作時,它會顯示包含連結的訊息列,該連結會開啟包含指示的 [手動驗證] 對話方塊。 執行手動步驟之後,系統管理員或使用者可以選擇繼續執行或拒絕執行。 在管線上具有「佇列組建」許可權的使用者可以繼續或拒絕執行。

範例

  jobs:
  - job: waitForValidation
    displayName: Wait for external validation
    pool: server
    timeoutInMinutes: 4320 # job times out in 3 days
    steps:
    - task: ManualValidation@0
      timeoutInMinutes: 1440 # task times out in 1 day
      inputs:
        notifyUsers: |
          test@test.com
          example@example.com
        instructions: 'Please validate the build configuration and resume'
        onTimeout: 'resume'