Azure DevOps 2019：主流水线按环境调度子流水线避免重复配置

核心思路 #

通过通用模板文件+参数化传递+条件分支逻辑实现复用，只需要1个基础附加流水线模板，配合主流水线的环境参数，就能覆盖3种环境的差异化执行，完全不需要创建9个重复的pipelineX.yml文件。

具体实现步骤 #

1. 编写通用附加流水线模板（pipeline-template.yml） #

这个模板是所有环境共用的核心载体，通过参数接收环境标识，用条件判断处理环境差异逻辑，通用逻辑直接复用：

parameters:
  - name: environment
    type: string
    values:
      - dev
      - test
      - prod

variables:
  # 按需绑定对应环境的变量组（提前在Azure DevOps中创建Dev/Test/Prod变量组）
  - ${{ if eq(parameters.environment, 'dev') }}:
      - group: Dev-Vars
  - ${{ if eq(parameters.environment, 'test') }}:
      - group: Test-Vars
  - ${{ if eq(parameters.environment, 'prod') }}:
      - group: Prod-Vars

steps:
  - script: echo "初始化${{ parameters.environment }}环境"
    displayName: "环境前置准备"

  # 环境差异化步骤
  - ${{ if eq(parameters.environment, 'dev') }}:
      - task: DownloadSecureFile@1
        inputs:
          secureFile: dev-appsettings.json
        displayName: "下载Dev环境配置"
  - ${{ if eq(parameters.environment, 'test') }}:
      - task: DownloadSecureFile@1
        inputs:
          secureFile: test-appsettings.json
        displayName: "下载Test环境配置"
  - ${{ if eq(parameters.environment, 'prod') }}:
      - task: DownloadSecureFile@1
        inputs:
          secureFile: prod-appsettings.json
        displayName: "下载Prod环境配置"

  # 全环境通用部署逻辑
  - script: |
      echo "启动${{ parameters.environment }}环境服务部署"
      dotnet publish -c Release -o $(Build.ArtifactStagingDirectory)
    displayName: "执行项目构建"

  - task: PublishBuildArtifacts@1
    inputs:
      PathtoPublish: '$(Build.ArtifactStagingDirectory)'
      ArtifactName: '${{ parameters.environment }}-deploy-package'
    displayName: "上传部署包"

2. 配置主流水线入口（按需拆分3个或用1个） #

方案A：拆分3个环境专属主流水线（适配自动触发场景）

分别创建runner-dev.yml、runner-test.yml、runner-prod.yml，每个文件仅需调用模板并传入对应环境参数：

# runner-dev.yml
trigger:
  branches:
    include:
      - main
  paths:
    include:
      - src/dev/* # 可选：仅当Dev相关代码变更时触发

extends:
  template: pipeline-template.yml
  parameters:
    environment: dev

runner-test.yml和runner-prod.yml只需修改environment参数和触发器路径即可，逻辑完全一致。

方案B：单主流水线+运行时参数（适配手动触发场景）

如果不需要自动触发，可创建单个runner-pipeline.yml，通过运行时参数选择目标环境：

parameters:
  - name: targetEnvironment
    type: string
    default: dev
    values:
      - dev
      - test
      - prod

trigger: none # 关闭自动触发，改为手动启动时选择环境

extends:
  template: pipeline-template.yml
  parameters:
    environment: ${{ parameters.targetEnvironment }}

3. Azure DevOps 2019 适配注意事项 #

• 确保模板文件与主流水线文件在同一代码仓库，2019版本不支持跨仓库引用模板。
• 变量组需提前在项目设置中创建，绑定对应环境的敏感配置（如数据库连接串、密钥）。
• 避免使用2020+版本新增的templateContext等高级语法，仅用基础的if条件判断和参数传递即可兼容。

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