使用此任务可暂停 YAML 管道运行以等待手动交互。
语法
# Manual validation v0
# 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.
# 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
,这是所有任务中可用的 常见任务属性。