Azure DevOps构建管道：基于变量条件排除Nuget.Config触发路径

当前状态 #

多个产品团队共享不可修改的build.yml文件，用于创建生成并发布产品文档的Azure DevOps构建管道。各团队通过自定义variables.yml文件设置变量，实现管道的个性化定制，现有示例如下：

build.yml #

variables:
- template: variables.yml

trigger:
  batch: true
  branches:
    include:
    - main

steps:
- task: Bash@3
  condition: eq(variables['RaiseRelativeStylePaths'], 'true')
  inputs:
    filePath: '$(Build.SourcesDirectory)$(DocsRootDirectory)/stylesPath.sh'

variables.yml #

variables:
- name: RaiseRelativeStylePaths
  value: true

需求 #

希望通过类似的变量控制方式，借助ExcludeNugetConfig变量，实现仅当变量为true时，排除Nuget.Config文件触发管道。原尝试的语法不符合Azure DevOps规范，错误示例如下：

错误尝试（build.yml） #

trigger:
  batch: true
  branches:
    include:
    - master
  paths:
    condition: eq(variables['ExcludeNugetConfig'], 'true')
    exclude:
      - Nuget.Config

对应的variables.yml #

- name: ExcludeNugetConfig
  value: true

正确实现方案 #

Azure DevOps的trigger.paths节点不支持直接添加条件判断，可通过以下两种方案实现需求：

方案1：动态注入paths配置 #

利用Azure DevOps模板的条件渲染能力，在variables.yml中定义完整的paths配置，再在build.yml中根据变量决定是否启用：

带开关的variables.yml

variables:
# 保留原有变量
- name: RaiseRelativeStylePaths
  value: true

# 控制开关
- name: ExcludeNugetConfig
  value: true

# 根据开关动态生成paths内容
- name: TriggerPaths
  ${{ if eq(variables.ExcludeNugetConfig, 'true') }}:
    value: |
      exclude:
        - Nuget.Config
  ${{ else }}:
    value: ""

对应的build.yml修改

variables:
- template: variables.yml

trigger:
  batch: true
  branches:
    include:
    - master
  # 仅当TriggerPaths不为空时，注入paths配置
  ${{ if ne(variables.TriggerPaths, '') }}:
    paths: ${{ variables.TriggerPaths }}

方案2：通过阶段条件跳过管道 #

如果需求是避免Nuget.Config变更触发管道执行，可在管道开头添加检查阶段，结合变量控制是否跳过后续构建：

修改后的build.yml

variables:
- template: variables.yml

trigger:
  batch: true
  branches:
    include:
    - master

stages:
- stage: CheckSkipTrigger
  jobs:
  - job: DetectNugetConfigChange
    steps:
    - bash: |
        # 检查本次提交是否修改了Nuget.Config
        if git diff --name-only HEAD~1 HEAD | grep -q "Nuget.Config"; then
          echo "##vso[task.setvariable variable=HasNugetChange;isOutput=true]true"
        else
          echo "##vso[task.setvariable variable=HasNugetChange;isOutput=true]false"
        fi
      name: ChangeCheck

- stage: BuildAndPublishDocs
  dependsOn: CheckSkipTrigger
  # 条件：开关关闭，或无Nuget.Config变更时才执行
  condition: |
    and(
      succeeded(),
      or(
        eq(variables.ExcludeNugetConfig, 'false'),
        eq(dependencies.CheckSkipTrigger.outputs['ChangeCheck.HasNugetChange'], 'false')
      )
    )
  jobs:
  - job: BuildDocs
    steps:
    # 保留原有的构建步骤
    - task: Bash@3
      condition: eq(variables['RaiseRelativeStylePaths'], 'true')
      inputs:
        filePath: '$(Build.SourcesDirectory)$(DocsRootDirectory)/stylesPath.sh'

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