ManualValidation@1 - 手動驗證 v1 工作

暫停管線執行以等候手動互動。 僅適用於 YAML 管線。

語法

# Manual validation v1
# Pause a pipeline run to wait for manual interaction. Works only with YAML pipelines.
- task: ManualValidation@1
  inputs:
    notifyUsers: # string. Required. Notify users. 
    #approvers: # string. Approvers. 
    #allowApproversToApproveTheirOwnRuns: false # boolean. Allow approvers to approve their own run. Default: false.
    #instructions: # string. Instructions. 
    #onTimeout: 'reject' # 'reject' | 'resume'. On timeout. Default: reject.

輸入

notifyUsers - 通知使用者
string。 必填。

將手動驗證擱置電子郵件傳送至以逗號分隔的特定使用者清單（或群組）。 您可以使用 [org name]\group 名稱語法，將電子郵件傳送給群組。

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

approvers - 核准者
string。

指定以逗號分隔的使用者/群組/專案小組清單，以執行手動驗證。 如果沒有輸入，具有佇列建置許可權的使用者就能夠採取動作。

allowApproversToApproveTheirOwnRuns - 允許核准者核准自己的執行
boolean。 預設值：false。

如果這是真的，核准者將能夠核准自己的執行。

instructions - 指示
string。

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

onTimeout - 逾時
string。 允許的值：reject、resume。 預設值：reject。

在等待指定的逾時或 30 天之後，自動拒絕或繼續此手動驗證，無論早於哪一天。

工作控制選項

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

輸出變數

沒有。

言論

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

重要

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

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

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

您可以使用選擇性的 timeoutInMinutes 參數來指定工作的逾時值，一般工作屬性。

注意

若要讓工作完全執行，包含此工作之作業（default = 60 minutes）的 timeoutInMinutes 值應該高於工作本身的 timeoutInMinutes 值。 請參閱預設作業逾時值。

提示

您可以使用變數在 notifyUsers 參數中指定電子郵件位址。

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

例子

  jobs:
  - job: waitForValidation
    displayName: Wait for external validation
    pool: server
    timeoutInMinutes: 4320 # job times out in 3 days
    steps:
    - task: ManualValidation@1
      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，傳統組建
執行於	伺服器
需求	沒有
功能	此工作不符合作業中後續工作的任何需求。
命令限制	任何
Settable 變數	任何
代理程式版本	所有支援的代理程式版本。
工作類別	部署