ManualValidation@0 - 手动验证 v0 任务
使用此任务暂停 YAML 管道运行,以等待手动交互。
语法
# 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
在所有任务中可用的 常见任务属性 。