Azure Pipelines定义阶段与分支报错：stages值异常问题

问题原因 #

你在build-and-deploy.yml的steps节点中调用了包含stages顶级节点的子模板，而Azure Pipelines的steps上下文仅允许存在步骤相关内容，无法直接嵌套stages这类顶级流水线元素，因此触发了"Unexpected value 'stages'"错误。

解决方法 #

1. 调整模板调用层级 #

将子模板的调用从steps节点移至stages节点，只有在stages级别才能引用包含stages定义的子模板。

修改build-and-deploy.yml的结构：

parameters:
  - name: allowDevDeployment
    type: boolean
    default: false
  - name: deploymentType
    type: string

stages:
  # 将原有构建步骤放入单独的stage（如果存在）
  - stage: Build
    jobs:
      - job: BuildJob
        steps:
          - script: echo Building the project
            # 其他构建步骤...
  # 根据参数引用对应的部署子模板
  - template: deploymentTypes/${{ parameters.deploymentType }}.yml@demo
    parameters:
      allowDevDeployment: ${{ parameters.allowDevDeployment }}

2. 确保子模板结构合规 #

子模板（如0.yml、1.yml）保持stages顶级节点的结构，示例：

parameters:
  - name: allowDevDeployment
    type: boolean
    default: false

stages:
  - stage: DeployToDev
    condition: |
      and(
        eq(variables['Build.SourceBranch'], 'refs/heads/develop'),
        ${{ parameters.allowDevDeployment }}
      )
    jobs:
      - job: DevDeploymentJob
        steps:
          - script: echo Deploying to development environment
            # 部署步骤...
  - stage: DeployToProd
    condition: eq(variables['Build.SourceBranch'], 'refs/heads/master')
    jobs:
      - job: ProdDeploymentJob
        steps:
          - script: echo Deploying to production environment
            # 部署步骤...

3. 验证主流水线参数传递 #

确保azure-pipeline.yml中正确传递参数到模板：

extends:
  template: build-and-deploy.yml@demo
  parameters:
    allowDevDeployment: true
    deploymentType: ${{ variables.selectDeploymentType }}

内容的提问来源于stack exchange，提问作者Anonymous Person