Azure DevOps标签触发源流水线后，依赖流水线未触发问题排查

核心问题分析 #

Azure Pipelines 默认的跨流水线资源触发不会自动识别源流水线的标签触发场景，需要显式配置触发器规则、条件判断，同时确保权限和参数传递逻辑正确。

步骤1：确认源流水线的标签触发配置 #

先确保源流水线本身的标签触发器正常工作，示例配置如下：

trigger:
  tags:
    include:
      - v*.*.*  # 匹配你的标签格式，比如v1.0.0、v2.1.3
pr: none  # 关闭PR触发，避免干扰标签触发逻辑

jobs:
- job: SourceBuild
  steps:
  - script: echo "源流水线由标签 $(Build.SourceBranchName) 触发"

步骤2：修正依赖流水线的资源触发器 #

依赖流水线需要将源流水线作为资源，明确匹配标签分支和标签规则，同时添加条件判断确保仅在源流水线由标签触发时运行：

resources:
  pipelines:
  - pipeline: SourcePipeline
    source: 你的源流水线名称  # 与Azure DevOps中流水线显示名称完全一致（区分大小写）
    trigger:
      branches:
        include:
          - refs/tags/*  # 监听源流水线的标签分支
      tags:
        include:
          - v*.*.*  # 与源流水线的标签格式保持一致

jobs:
- job: DependentDeploy
  # 条件判断：仅当源流水线触发分支为标签时执行
  condition: startsWith(variables['resources.pipeline.SourcePipeline.sourceBranch'], 'refs/tags/')
  steps:
  - script: echo "依赖流水线由源流水线标签 $(resources.pipeline.SourcePipeline.sourceBranchName) 触发"

步骤3：自动触发失败的备选方案（显式触发） #

如果自动资源触发仍不生效，可在源流水线末尾添加显式触发步骤，用Azure DevOps CLI强制触发依赖流水线并传递标签参数：

# 在源流水线的jobs节点下新增以下任务
- job: TriggerDependentPipeline
  dependsOn: SourceBuild
  condition: startsWith(variables['Build.SourceBranch'], 'refs/tags/')
  steps:
  - script: |
      az pipelines run --name "你的依赖流水线名称" --branch $(Build.SourceBranch) --variables TAG=$(Build.SourceBranchName)
    env:
      AZURE_DEVOPS_EXT_PAT: $(System.AccessToken)  # 使用系统内置令牌完成授权
    displayName: "触发依赖流水线"

关键检查项 #

• 权限验证：确保源流水线的服务账号（Project Collection Build Service）拥有依赖流水线的队列构建权限，可在依赖流水线的「设置」→「权限」中配置。
• 名称一致性：依赖流水线中source:字段必须与Azure DevOps里源流水线的显示名称完全匹配（大小写敏感）。
• 分支格式匹配：源流水线的Build.SourceBranch格式为refs/tags/xxx，依赖流水线的条件判断需对应此格式。

内容的提问来源于stack exchange，提问作者MR.Nate