Azure DevOps发布管道失败：自托管Docker代理版本需求不符求助

核心问题分析 #

你的自托管Docker代理能正常运行Pipeline，但Release Pipeline报错找不到满足azureps和Agent.Version -gtVersion 2.144.0需求的代理——即便代理实际版本远高于要求值，问题大概率出在Release阶段的需求配置偏差或代理能力未被正确识别上。

具体排查步骤 #

• 检查Release Pipeline的代理需求配置
  进入Release Pipeline编辑页，定位到对应阶段的「代理作业」，查看「需求」模块：

  1. 确认是否手动添加了azureps和Agent.Version -gtVersion 2.144.0的强制要求
  2. 若为冗余配置，直接删除；若确实需要azureps，则需确保代理已安装Azure PowerShell模块

• 验证代理的已注册能力
  登录Azure DevOps，进入「项目设置」→「代理池」→「Default池」，找到你的自托管Docker代理：

  1. 查看「能力」列表，确认Agent.Version是否正确显示为当前运行的高版本
  2. 检查是否存在azureps相关能力项，若无则说明代理未识别到Azure PowerShell模块

• 检查Docker代理内部的Azure PowerShell安装状态
  进入代理容器内部，执行命令验证：

  Get-Module -ListAvailable Az
  

  若无返回结果，需在Docker镜像中添加安装步骤，例如：

  RUN Install-Module -Name Az -AllowClobber -Force -Scope AllUsers
  

• 重启代理并刷新能力

  1. 停止并重新启动Docker代理容器
  2. 在Azure DevOps代理池页面，点击代理的「刷新能力」按钮，等待数分钟后再次检查能力列表

• 确认Release Pipeline的代理池选择
  检查Release阶段是否误选了其他未配置该代理的池，确保使用的是「Default」池

额外测试方案 #

若以上步骤无效，可在Release Pipeline的代理作业中添加自定义需求，指定代理名称强制匹配：

Agent.Name -equals 你的代理名称

强制使用目标代理运行，验证是否能绕过需求匹配问题。

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