ManualValidation@0 - 手動驗證 v0 工作

發行項
06/02/2023

使用此工作暫停 YAML 管線執行以等候手動互動。

Syntax

# Manual validation v0
# [PREVIEW] Pause a pipeline run to wait for manual interaction. Works only with YAML pipelines.
- task: ManualValidation@0
  inputs:
    notifyUsers: # string. Required. Notify users. 
    #instructions: # string. Instructions. 
    #onTimeout: 'reject' # 'reject' | 'resume'. On timeout. Default: reject.

輸入

notifyUsers - 通知使用者
string. 必要。

將手動驗證擱置的電子郵件傳送給特定使用者 (或群組) 。只有具有佇列組建許可權的使用者才能對手動驗證採取行動。您可以使用語法，將電子郵件傳送至群組 [org name]\group name 。

此工作輸入是必要的，但如果您不想通知任何人，可以指定空字串，例如在測試回合期間： notifyUsers: '' 。

instructions - 指示
string.

指定繼續或拒絕手動介入時向使用者顯示的指示。根據這些指示，使用者將會針對此手動介入做出明智的決策。

onTimeout - 逾時時
string. 允許值：reject 和 resume。預設值：reject。

在指定的逾時或早于 30 天擱置後，自動拒絕或繼續此手動驗證。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。如需詳細資訊，請參閱控制選項和一般工作屬性。

輸出變數

無。

備註

在 YAML 管線中使用這項工作，在階段內暫停執行。這通常會執行來執行各種手動步驟或動作，然後繼續或拒絕執行。

重要

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

手動驗證工作可讓您在階段內暫停管線執行，通常是執行一些手動步驟或動作，然後繼續進行管線。例如，使用者可能需要在管線啟動長時間執行的計算密集作業之前，手動驗證特定部署設定。

手動驗證工作組態包含指示參數，可用來提供相關資訊，或指定使用者在暫停期間執行的手動步驟。您可以在等候檢閱時將電子郵件通知設定為傳送電子郵件通知給使用者和使用者群組，並在發生可設定的逾時之後指定自動回應 (拒絕或繼續) 。

您可以使用一般工作屬性中可用的選擇性 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'

規格需求

需求	描述
管線類型	YAML、傳統組建
在上執行	伺服器
要求	無
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任意
可設定變數	任意
代理程式版本	所有支援的代理程式版本。
工作類別	部署