执行Maven测试自动化项目构建管道遇Agent匹配错误求助

问题复现 #

构建管道执行时触发错误：

##[error]No agent found in pool CLMCICDAZ_TestAutomation_POC which satisfies the specified demands: maven, Agent.Version -gtVersion 2.144.0

已在自建（on-prem）代理上安装Maven 3.9.9、Maven 4.0.0 rc及JDK 17，Agent版本为3.234.0，但代理步骤仍执行失败。

解决方案 #

• 检查代理的Maven能力识别
  登录Azure DevOps，进入目标代理池CLMCICDAZ_TestAutomation_POC，找到对应自建代理的详情页：

  1. 查看「用户能力（User Capabilities）」列表，确认是否存在maven条目。
  2. 若不存在，手动添加：点击「Add capability」，设置Name为maven，Value填写Maven的安装路径或具体版本（如3.9.9）。
  3. 重启代理服务触发工具自动检测：Windows重启Azure Pipelines Agent服务；Linux运行./svc.sh restart。

• 验证管道需求配置
  检查YAML管道中的demands节点，确保拼写正确且格式合规：

  pool:
    name: CLMCICDAZ_TestAutomation_POC
    demands:
      - maven
      - Agent.Version -gtVersion 2.144.0
  

  注意需求名称大小写敏感，避免Maven或其他拼写错误。

• 确认代理状态与版本
  在代理机器上执行命令验证：

  • Windows：进入代理安装目录，运行config.cmd status
  • Linux/macOS：进入代理安装目录，运行./config.sh status
    确认输出显示Agent版本为3.234.0，且状态为「Online」。

• 排查代理池额外筛选条件
  检查管道配置是否添加了标签（tags）等额外筛选规则，导致自建代理被排除。确保仅指定目标代理池，无其他限制。

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