添加阶段、依赖项和条件

可以将管道作业分成几个阶段。 阶段是管道中的主要分支：阶段的典型示例包括“生成此应用”、“运行这些测试”和“部署到预生产环境”。 它们是管道中的逻辑边界，你可在其中暂停管道并执行各种检查。

即使未显式定义管道，每个管道至少有一个阶段。 还可以将阶段排列到依赖项关系图中，以便一个阶段先于另一个阶段运行。 一个阶段最多可以有 256 个作业。

最简单的情况是，管道中不需要逻辑边界。 对于这些方案，可以直接在 YAML 文件中指定作业，而无需关键字 stages 。 例如，如果你有一个简单的管道来生成和测试小型应用程序，而无需单独的环境或部署步骤，则可以直接定义所有作业，而无需使用阶段。

pool:
  vmImage: 'ubuntu-latest'

jobs:
- job: BuildAndTest
  steps:
  - script: echo "Building the application"
  - script: echo "Running tests"

此管道有一个隐式阶段和两个任务。 stages关键字未使用，因为只有一个阶段。

jobs:
- job: Build
  steps:
  - bash: echo "Building"

- job: Test
  steps:
  - bash: echo "Testing"

若要将管道组织到多个阶段，请使用 stages 关键字。 此 YAML 定义了一个管道，其中包含两个阶段，其中每个阶段包含多个作业，每个作业都有要执行的特定步骤。

stages:
- stage: A
  displayName: "Stage A - Build and Test"
  jobs:
  - job: A1
    displayName: "Job A1 - build"
    steps:
    - script: echo "Building the application in Job A1"
      displayName: "Build step"
  - job: A2
    displayName: "Job A2 - Test"
    steps:
    - script: echo "Running tests in Job A2"
      displayName: "Test step"

- stage: B
  displayName: "Stage B - Deploy"
  jobs:
  - job: B1
    displayName: "Job B1 - Deploy to Staging"
    steps:
    - script: echo "Deploying to staging in Job B1"
      displayName: "Staging deployment step"
  - job: B2
    displayName: "Job B2 - Deploy to Production"
    steps:
    - script: echo "Deploying to production in Job B2"
      displayName: "Production deployment step"

如果在阶段级别指定pool，则该阶段中的所有作业都使用该池，除非在作业级别指定该池。

stages:
- stage: A
  pool: StageAPool
  jobs:
  - job: A1 # will run on "StageAPool" pool based on the pool defined on the stage
  - job: A2 # will run on "JobPool" pool
    pool: JobPool

在管道中定义多个阶段时，它们会默认按照 YAML 文件中定义的顺序运行。 添加依赖项时除外。 对于依赖项，阶段按 dependsOn 要求的顺序运行。

管道必须包含至少一个没有依赖项的阶段。

有关如何定义阶段的详细信息，请参阅 YAML 架构中的阶段。

以下示例阶段按顺序运行。 如果不使用 dependsOn 关键字，则分阶段按定义的顺序运行。

stages:
- stage: Build
  displayName: "Build Stage"
  jobs:
  - job: BuildJob
    steps:
    - script: echo "Building the application"
      displayName: "Build Step"

- stage: Test
  displayName: "Test Stage"
  jobs:
  - job: TestJob
    steps:
    - script: echo "Running tests"
      displayName: "Test Step"

并行运行的示例阶段：

stages:
- stage: FunctionalTest
  displayName: "Functional Test Stage"
  jobs:
  - job: FunctionalTestJob
    steps:
    - script: echo "Running functional tests"
      displayName: "Run Functional Tests"

- stage: AcceptanceTest
  displayName: "Acceptance Test Stage"
  dependsOn: [] # Runs in parallel with FunctionalTest
  jobs:
  - job: AcceptanceTestJob
    steps:
    - script: echo "Running acceptance tests"
      displayName: "Run Acceptance Tests"

扇出和扇入行为的示例：

stages:
- stage: Test

- stage: DeployUS1
  dependsOn: Test    #  stage runs after Test

- stage: DeployUS2
  dependsOn: Test    # stage runs in parallel with DeployUS1, after Test

- stage: DeployEurope
  dependsOn:         # stage runs after DeployUS1 and DeployUS2
  - DeployUS1
  - DeployUS2

示例：根据前一阶段的运行状态来运行某一阶段。

stages:
- stage: A

# stage B runs if A fails
- stage: B
  condition: failed()

# stage C runs if B succeeds
- stage: C
  dependsOn:
  - A
  - B
  condition: succeeded('B')

使用自定义条件的示例：

stages:
- stage: A

- stage: B
  condition: and(succeeded(), eq(variables['build.sourceBranch'], 'refs/heads/main'))

YAML 管道不支持队列策略。 管道的每个运行都独立于其他运行，并且不知道其他运行。 换句话说，您的两个连续提交可能会触发两个管道，并且两个管道将执行相同的步骤顺序，而不需要互相等待。 虽然我们努力将队列策略引入 YAML 管道，但我们建议你使用手动审批，以便手动排序和控制执行顺序（如果这很重要）。

您可以使用审批检查手动控制某个阶段何时运行。 这通常用于控制向生产环境进行的部署。 检查是资源所有者可用的一种机制，用于控制管道中的阶段是否以及何时可以使用资源。 作为资源（如环境）的所有者，你可以定义在使用该资源的阶段可以启动之前必须满足的检查。

目前，环境支持手动审批检查。 有关详细信息，请参阅审批。