如何在Azure DevOps容器选项中使用自托管代理的环境变量？

问题本质 #

代理池配置的代理功能变量属于代理运行时环境变量，而Azure Pipelines的容器配置（container字段）在作业初始化阶段执行——此时模板表达式（${{ }}）仅能访问编译时/管道初始化阶段的变量，还无法获取代理的运行时变量；运行时表达式（$( )）在容器选项中不会被Azure Pipelines解析，会直接传递给Docker，导致路径错误。

可行解决方案：分作业传递变量 #

通过拆分两个作业实现变量的跨阶段传递，绕开容器初始化时机的限制：

1. 第一个作业在目标代理上运行，读取代理的功能变量并设置为管道输出变量
2. 第二个作业依赖第一个作业，引用输出变量配置容器选项

具体YAML示例 #

stages:
- stage: CaptureAgentCapability
  jobs:
  - job: GetDevicePath
    pool:
      name: 你的自托管代理池名称
    steps:
    - bash: |
        # 代理功能变量会作为环境变量注入作业，直接读取即可
        echo "代理上的TEST变量值: $TEST"
        # 将变量设为输出变量，传递给后续阶段
        echo "##vso[task.setvariable variable=DEVICE_PATH;isOutput=true]$TEST"
      name: SetDeviceVariable

- stage: RunContainerJob
  dependsOn: CaptureAgentCapability
  jobs:
  - job: ContainerTask
    pool:
      name: 你的自托管代理池名称
    variables:
      # 引用前一阶段的输出变量
      AGENT_DEVICE: $[ stageDependencies.CaptureAgentCapability.GetDevicePath.outputs['SetDeviceVariable.DEVICE_PATH'] ]
    container:
      image: $(DOCKER_IMAGE)
      # 用模板表达式引用管道变量，此时变量已在管道层面可用
      options: --device=${{ variables.AGENT_DEVICE }}
    steps:
    - bash: echo "容器启动参数中的设备路径: $AGENT_DEVICE"

关键说明 #

• 第一个作业必须在目标自托管代理上运行，才能获取该代理的功能变量
• 使用stageDependencies跨阶段引用输出变量，确保第二个作业拿到正确的代理变量值
• 容器选项中用${{ variables.AGENT_DEVICE }}模板表达式，此时变量已成为管道预定义变量，能在作业初始化阶段被解析

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