steps.task definition

步骤 task 运行任务。

所有任务都支持以下一组通用属性。

steps:
- task: string # Required as first property. Name of the task to run.
  inputs: # Inputs for the task.
    string: string # Name/value pairs
  condition: string # Evaluate this condition expression to determine whether to run this task.
  continueOnError: boolean # Continue running even on failure?
  displayName: string # Human-readable name for the task.
  target: string | target # Environment in which to run this task.
  enabled: boolean # Run this task when the job runs?
  env: # Variables to map into the process's environment.
    string: string # Name/value pairs
  name: string # ID of the step.
  timeoutInMinutes: string # Time to wait for this task to complete before the server kills it.
  retryCountOnTaskFailure: string # Number of retries if the task fails.

引用此定义的定义： 步骤

属性

task 字符串。 作为第一个属性是必需的。
要运行的任务的名称。

inputs 字符串字典。
任务的输入。

condition 字符串。
计算此条件表达式以确定是否运行此任务。

continueOnError布尔值。
即使发生故障，仍要继续运行？

displayName 字符串。
任务的用户可读名称。

targettarget。
要在其中运行此任务的环境。

enabled布尔值。
在作业运行时运行此任务？

env 字符串字典。
要映射到进程的环境的变量。

name 字符串。
步骤的 ID。 可接受的值：[-_A-Za-z0-9]*。

timeoutInMinutes 字符串。
在服务器终止此任务之前等待此任务完成的时间。 例如，若要配置 10 分钟超时，请使用 timeoutInMinutes: 10。

注意

管道可以配置作业级别超时。 如果作业级别超时间隔在步骤完成之前已过，则正在运行的作业 (包括步骤) 也会终止，即使该步骤配置了较长 timeoutInMinutes 的间隔也是如此。 有关详细信息，请参阅 超时。

retryCountOnTaskFailure 字符串。
如果任务失败，则重试次数。

注解

任务是管道的构建块。 有一个任务目录可供选择。

如果未指定命令模式，则可以将 target 结构缩短为：

- task:
  target: string  # container name or the word 'host'

常见任务属性

除 和 inputs外name，所有任务都支持一组通用属性。 有关常见任务属性的列表，请参阅前面的 属性 部分。 有关配置这些属性的详细信息，请参阅 任务控制选项 和 任务环境变量。

详细了解 条件、 超时和 步骤目标。

示例

steps:
- task: VSBuild@1
  displayName: Build
  timeoutInMinutes: 120
  inputs:
    solution: '**\*.sln'

另请参阅

• 任务
• 任务目录