Azure Pipelines：YAML任务读取流水线文件夹路径及层级变量继承问询

一、获取流水线所在文件夹路径 #

Azure DevOps没有直接提供预定义变量返回流水线的文件夹路径，但可以通过REST API在YAML任务中动态获取：

# PowerShell任务示例，获取并输出流水线文件夹路径
$pipelineId = $(System.DefinitionId)
$org = "$(System.TeamFoundationCollectionUri)" -replace 'https://dev.azure.com/','' -replace '/',''
$proj = "$(System.TeamProject)"
$token = "$(System.AccessToken)"

$headers = @{ Authorization = "Bearer $token" }
$response = Invoke-RestMethod -Uri "https://dev.azure.com/$org/$proj/_apis/pipelines/$pipelineId?api-version=7.1-preview.1" -Headers $headers
$folderPath = $response.folder

# 将路径设为可跨阶段使用的管道变量
Write-Host "##vso[task.setvariable variable=PipelineFolder;isOutput=true]$folderPath"

执行后，后续任务可通过$(PipelineFolder)引用该路径变量。

二、库外实现文件夹级变量继承 #

如果不想依赖变量库，可通过两种方式模拟TeamCity的文件夹变量继承逻辑：

1. 条件变量赋值
   直接在YAML中根据文件夹路径设置变量：

variables:
  - name: DefaultEnv
    value: 'dev'
  # 根据文件夹路径覆盖默认值
  - ${{ if contains(variables.PipelineFolder, '/prod/') }}:
    - name: DefaultEnv
      value: 'prod'
  - ${{ if contains(variables.PipelineFolder, '/staging/') }}:
    - name: DefaultEnv
      value: 'staging'

2. 模板文件拆分
   按文件夹结构创建对应的变量模板，动态引用：

# 主YAML文件
variables:
  # 将路径斜杠替换为连字符，匹配模板文件名
  - template: "templates/vars/${{ replace(variables.PipelineFolder, '/', '-') }}.yml"

示例模板文件templates/vars--prod.yml：

variables:
  - name: Env
    value: 'prod'
  - name: DeployTarget
    value: 'prod-cluster'

三、基于流水线文件夹选择变量库 #

可结合条件逻辑，根据文件夹路径动态加载对应变量库：

编译时条件（适用于静态文件夹路径）

如果文件夹路径是固定的，可直接用编译时条件：

variables:
  - ${{ if eq(variables.PipelineFolder, '/prod') }}:
    - group: Prod-Vars
  - ${{ if eq(variables.PipelineFolder, '/staging') }}:
    - group: Staging-Vars

运行时动态选择（适用于动态路径）

若路径是通过API动态获取的，需分阶段处理：

stages:
  - stage: FetchFolder
    jobs:
      - job: GetFolderPath
        steps:
          - powershell: |
              # 此处复用前面获取文件夹路径的脚本
              $pipelineId = $(System.DefinitionId)
              $org = "$(System.TeamFoundationCollectionUri)" -replace 'https://dev.azure.com/','' -replace '/',''
              $proj = "$(System.TeamProject)"
              $token = "$(System.AccessToken)"

              $headers = @{ Authorization = "Bearer $token" }
              $response = Invoke-RestMethod -Uri "https://dev.azure.com/$org/$proj/_apis/pipelines/$pipelineId?api-version=7.1-preview.1" -Headers $headers
              $folderPath = $response.folder

              Write-Host "##vso[task.setvariable variable=PipelineFolder;isOutput=true]$folderPath"
            name: SetFolderVar

  - stage: Deploy
    dependsOn: FetchFolder
    variables:
      PipelineFolder: $[ stageDependencies.FetchFolder.GetFolderPath.outputs['SetFolderVar.PipelineFolder'] ]
    jobs:
      - job: DeployJob
        steps:
          # 根据路径动态加载变量库（通过脚本实现）
          - powershell: |
              switch ($(PipelineFolder)) {
                '/prod' { Write-Host "##vso[task.setvariable variable=VarGroup;isOutput=true]Prod-Vars" }
                '/staging' { Write-Host "##vso[task.setvariable variable=VarGroup;isOutput=true]Staging-Vars" }
                default { Write-Host "##vso[task.setvariable variable=VarGroup;isOutput=true]Dev-Vars" }
              }
            name: SelectVarGroup
          # 使用变量库中的变量
          - script: echo $(VarGroup)

四、简化替代方案 #

如果不想依赖API调用，可手动给每个流水线添加自定义变量PipelineFolder，手动赋值为对应的文件夹路径，再基于该变量实现上述逻辑，虽然需要手动维护，但避免了API调用的复杂度。

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