基于PR目标分支在嵌套Azure DevOps模板中条件执行步骤的方案

由于System.PullRequest.TargetBranch属于运行时变量，无法直接在编译时的${{ }}表达式中引用，这里提供两种可行的解决思路：

方法1：编译时条件控制（通过参数传递分支信息） #

这种方式会在编译阶段就决定是否将level3模板的步骤加入管道，仅当目标分支为main时才会包含相关步骤。

修改后的各文件内容： #

main.yaml

resources:
  repositories:
    - repository: templates
      type: git
      name: MyProj/templates
      ref: refs/heads/main

extends:  
  template: extends/level1.yaml@templates
  parameters:     
    MY_STAGES:
      BUILD:
        displayName: "Build"
        L1Config:
          config1: "config1"
    # 传递PR目标分支作为参数（编译时可获取PR上下文变量）
    PullRequestTargetBranch: ${{ variables.System.PullRequest.TargetBranch }}

level1.yaml

parameters:
  - name: MY_STAGES
    type: object
    default: {}
  - name: L1Config
    type: object
    default: {}
  # 新增参数接收PR目标分支
  - name: PullRequestTargetBranch
    type: string
    default: ""
  
variables:  
  - name: var1
    value: "value1"
  - name: var2    
    value: "val2"

stages:
  - ${{ each MY_STAGE in parameters.MY_STAGES }}:
      - stage: ${{ MY_STAGE.key }}
        displayName: "Build"        
        jobs:
          - job: build_dev
            displayName: Build
            steps:
              - template: /jobs/level2@templates
                parameters:
                  L2Config: ${{ MY_STAGE.value.L1Config }}
                  # 将分支参数传递给level2模板
                  PullRequestTargetBranch: ${{ parameters.PullRequestTargetBranch }}

level2.yaml

parameters:
  - name: L2Config
    type: object
    default: {}
  # 新增参数接收PR目标分支
  - name: PullRequestTargetBranch
    type: string
    default: ""
        
steps:
  - pwsh: Write-Host "Hello World!"   
  
  # 通过编译时参数判断是否调用level3模板
  - ${{ if and(ne(parameters.PullRequestTargetBranch, ''), eq(parameters.PullRequestTargetBranch, 'refs/heads/main')) }}: 
    - template: /steps/level3@templates
      parameters:
        param1: value1

方法2：运行时条件控制（直接给模板步骤加执行条件） #

这种方式会将level3模板的步骤编译进管道，但仅在运行时满足分支条件时才执行，适合不需要隐藏步骤结构的场景。

修改后的level2.yaml #

parameters:
  - name: L2Config
    type: object
    default: {}
        
steps:
  - pwsh: Write-Host "Hello World!"   
  
  # 给模板引用添加运行时条件，仅当PR目标分支为main时执行
  - template: /steps/level3@templates
    parameters:
      param1: value1
    condition: and(succeeded(), variables['System.PullRequest.TargetBranch'], eq(variables['System.PullRequest.TargetBranch'], 'refs/heads/main'))

注意事项 #

• 两种方法都仅适用于PR触发的管道场景；若管道可能由非PR事件触发，需添加额外判断避免变量不存在的错误。
• 方法1更适合严格控制管道结构的场景，方法2则更简洁，无需逐层传递参数。

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