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。 允许的值:rejectresume。 默认值: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'

此示例使用 timeoutInMinutes,这是所有任务中可用的 常见任务属性

要求

要求 描述
管道类型 YAML,经典生成
运行时间 服务器
需求 没有
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任何
Settable 变量 任何
代理版本 所有支持的代理版本。
任务类别 部署