任务类型和使用情况

在 YAML 中，可以在任务名称中使用指定主版本 @ 。 例如，若要使用任务版本 2 PublishTestResults ，请指定 PublishTestResults@2。 可以通过在后面提供完整的任务版本号 @来指定要使用的次要版本，例如 GoTool@0.3.1。

在经典管道中，每个任务都有一个 版本 选择器，用于选择所需的版本。 请考虑克隆管道，并使用新的主任务版本测试克隆的管道。 如果选择预览版（如 1.* 预览版），该版本仍在开发中，并且可能存在问题。

如果更改版本并遇到生成问题，可以从“ 历史记录 ”选项卡还原管道更改。对于发布管道，无法还原到旧版本。 必须手动还原发布管道的更改，然后保存管道。

以下属性可用于 YAML 管道 task 步骤。 有关详细信息，请参阅 steps.task 定义。

条件

任务无法确定任务完成后是否继续管道作业，仅提供结束状态，例如 succeeded 或 failed。 然后，下游任务和作业可以基于该状态设置， condition 以确定是否要运行。

conditions 属性指定运行此任务的条件。 默认情况下，如果作业中没有任何内容失败，并且紧靠在作业完成前的步骤，则步骤将运行。

你可以通过设置要运行的步骤来替代或自定义这些默认值，即使以前的依赖项失败或有另一个结果也是如此。 还可以定义由表达式组成的自定义条件。

基于以前的依赖项状态的条件包括：

• 成功：仅当所有以前的依赖项都成功时运行。 如果未在 YAML 中设置任何条件，则此行为是默认值。 若要应用此条件，请指定 condition: succeeded()。
• 成功或失败：即使以前的依赖项失败，也运行，除非取消运行。 若要应用此条件，请指定 condition: succeededOrFailed()。
• 始终：即使以前的依赖项失败，运行也会失败，即使已取消运行。 若要应用此条件，请指定 condition: always()。
• 失败：仅在以前的依赖项失败时运行。 若要应用此条件，请指定 condition: failed()。

在以下 YAML 示例中， PublishTestResults@2 即使上一步失败，也因 其成功OrFailed 条件而运行。

steps:
- task: UsePythonVersion@0
  inputs:
    versionSpec: '3.x'
    architecture: 'x64'
- task: PublishTestResults@2
  inputs:
    testResultsFiles: "**/TEST-*.xml"
  condition: succeededOrFailed()

出错时继续

该 continueOnError 属性告知任务是否继续运行并报告成功，而不考虑失败。 如果设置为 />，则此属性指示任务忽略 状态并继续运行。 下游步骤和作业在做出运行决策时将任务结果视为这些结果 success 。

已启用

默认情况下，每当作业运行时，任务将运行。 可以设置为enabledfalse禁用任务。 暂时禁用该任务对于出于测试目的或特定部署从流程中删除任务非常有用。

任务失败的重试计数

该 retryCountOnTaskFailure 属性指定在任务失败时重试任务的次数。 默认值为零个条目。

• 允许的最大重试次数为 10。
• 每次尝试失败后，重试前的等待时间都会增加，遵循指数退避策略。 第一次重试发生在 1 秒后，第二次重试 4 秒，第 1 次重试后为 100 秒。
• 重试任务不提供幂等性。 第一次尝试的副作用（例如部分创建外部资源）可能会导致重试失败。
• 没有有关任务可用的重试次数的信息。
• 任务失败会向任务日志添加警告，指示在重试任务之前失败。
• 所有重试尝试都显示在 UI 中，作为同一任务节点的一部分。

resources:
  containers:
  - container: pycontainer
    image: python:3.11

steps:
- task: SampleTask@1
  target: host
- task: AnotherTask@1
  target: pycontainer

超时

超时期限从任务开始运行时开始，不包括任务排队或正在等待代理的时间。

在经典管道中，任务提供了多个 控制选项。

已启用

清除 “启用” 复选框以禁用任务。 暂时禁用该任务对于出于测试目的或特定部署从流程中删除任务非常有用。

出错时继续

如果希望此任务报告成功，即使任务失败，也可以允许同一作业中的依赖任务运行，请选择此选项。 整体生成或部署不能超过部分成功。 后续任务是否运行也取决于其 运行此任务 设置。

任务失败后的重试次数

指定此任务失败时的重试次数。 默认值为零。

• 失败的任务重试时间（以秒为单位）。 每次尝试失败后重试前的等待时间都会增加。
• 重试任务不提供幂等性。 第一次尝试的副作用（例如部分创建外部资源）可能会导致重试失败。
• 没有有关重试计数的信息可供任务使用。
• 任务失败会向任务日志添加警告，指示在重试任务之前失败。
• 所有重试尝试都显示在 UI 中，作为同一任务节点的一部分。

超时

输入任务在自动取消之前可以运行的最长时间（以分钟为单位）。 默认值为 0或无限时间。 设置非零值会覆盖父任务作业的设置。 超时期限从任务开始运行时开始，不包括任务排队或正在等待代理的时间。

运行此任务

选择以下条件之一来运行此任务：

• 仅当以前的所有任务都成功时。 此条件为默认值。
• 即使上一个任务失败，除非取消生成
• 即使上一个任务失败，即使已取消生成
• 仅当上一个任务失败时
• 自定义条件，然后输入一个 自定义条件 ，指定此任务何时应运行的表达式。

YAML 管道任务可以指定一个 env 属性，该属性列出表示环境变量的名称/值字符串。

- task: AzureCLI@2
  env:
    ENV_VARIABLE_NAME: value
    ENV_VARIABLE_NAME2: value
  ...

可以使用步骤或命令行、Bash 或 PowerShell 任务中的脚本来设置环境变量 script 。

以下示例运行一个 script 步骤，该步骤将值 ENV_VARIABLE_NAME 分配给环境变量并回显该值。

- script: echo "This is " $ENV_VARIABLE_NAME
  env:
    ENV_VARIABLE_NAME: value
  displayName: 'echo environment variable'

上述脚本在功能上与使用输入运行 Bash@3 任务 script 相同。 以下示例使用 task 语法。

- task: Bash@3
  inputs:
    script: echo "This is " $ENV_VARIABLE_NAME
  env:
    ENV_VARIABLE_NAME: value
  displayName: 'echo environment variable'

在经典管道中，可以在任务编辑器的“环境变量 ”部分中添加 和编辑环境变量。

在项目的基目录中创建 包含以下内容的azure-pipelines.yml 文件。

pool:
  vmImage: 'windows-latest'

jobs:
- job: NodeJS
  strategy:
    matrix:
      node14:
        nodeVersion: '14.x'
      node16:
        nodeVersion: '16.x'
    maxParallel: 2
  steps:
    - task: NodeTool@0
      displayName: 'Install Node.js $(nodeVersion)'
      inputs:
        versionSpec: '$(nodeVersion)'
        checkLatest: true

    - script: |
        echo Using Node version $(nodeVersion)
        node --version
      displayName: 'Verify Node Installation'

保存并运行管道。 作业运行两次，每个版本的变量中 nodeVersion 指定的 Node.js 各运行一个。

Node.js 工具安装程序可下载 Node.js 版本（如果尚未安装在代理上）。 命令行脚本将已安装的版本写入命令行。

1. 在经典管道的 代理作业 中，在 “执行计划”下，将 并行度 设置为 多配置。

2. 在 乘数下，输入 nodeVersion。

3. 将 代理的最大数目 设置为 2。

4. 使用以下设置将 Node.js 工具安装程序 任务添加到管道：

   • 在版本规范下输入 $（nodeVersion）。
   • 选中“ 检查最新版本”复选框。

5. 将 命令行 任务添加到管道，并在 “脚本”下输入以下代码：

   echo Using Node version $(nodeVersion)
node --version

6. 在“变量”选项卡上，使用值 14.x、16.x 定义变量 nodeVersion，并在队列时选择 Settable。

   注意

   在发布管道中，在 发布时选择 Settable。 有关详细信息，请参阅 如何在发布时编辑变量？

7. 选择保存并排队。

8. 在 “运行管道 ”屏幕上，选择“ 保存并运行”。

作业运行两次，每个版本的变量中 nodeVersion 指定的 Node.js 各运行一个。 如果Node.js 工具安装程序任务尚未在代理上，则下载 Node.js 版本。 命令行任务日志可记录 Node.js 版本在磁盘上的位置。