ManualValidation@0 - 手動驗證 v0 工作

發行項
04/29/2024

使用此工作來暫停 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 參數來指定工作的逾時值。

注意

若要讓工作完全執行， timeoutInMinutes 包含此工作的作業 (值) default = 60 minutes 應高於 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'

此範例會使用 timeoutInMinutes ，這是所有工作中可用的通用工作屬性。

規格需求

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