Azure Pipeline自托管代理需求不匹配问题求助

1. 核实自托管代理的状态与属性 #

• 登录Azure DevOps，进入项目设置 -> 代理池 -> Default池，查看目标自托管代理：
  • 确认代理处于在线状态，未被禁用。
  • 点击代理详情，检查Agent.OS的值是否为Windows_NT——部分情况下，代理安装时的系统环境变量异常会导致该值不符。
  • 验证代理版本是否大于2.182.1，若版本过低，需升级至最新版。

2. 检查Pipeline需求逻辑的正确性 #

对照你的Pipeline配置，确认分支判断与需求添加的语法无错误，比如：

jobs:
- job: Build
  pool: 
    ${{ if eq(variables['Build.SourceBranchName'], 'master') }}:
      vmImage: 'windows-latest'
    ${{ else }}:
      name: Default
      demands:
        ${{ if ne(variables['Build.SourceBranchName'], 'merge') }}:
          - Agent.OS -equals Windows_NT
        - Agent.Version -gtVersion 2.182.1

可查看Pipeline运行时的作业需求详情（日志顶部），确认实际生效的需求是否符合预期，避免因分支名判断错误（比如变量名写错、分支名大小写不匹配）导致需求被错误添加。

3. 确认代理归属的池 #

检查自托管代理是否确实注册在Default池内——有时可能误将代理注册到了其他自定义池，需进入所有代理池列表逐一排查。

4. 手动验证代理的环境变量 #

在自托管代理所在机器上，进入代理安装目录，运行.\config.cmd run启动代理，查看启动日志中的Agent.OS和Agent.Version值，确认与需求完全匹配。若日志中OS值不是Windows_NT，可尝试重新注册代理，或检查系统环境变量的配置。

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