Azure DevOps发布管道因部署组部分机器离线失败的解决咨询

问题原因 #

你遇到的报错Deployment Group deployment configuration settings are not met.，本质是默认部署组任务要求所有指定的目标机器必须满足在线（代理可用）的条件，只要有一台机器离线，就会触发配置不满足的校验，导致整个发布管道失败。

内置配置解决方案（优先推荐） #

1. 调整目标机器的要求规则

• 编辑你的发布管道，找到对应的Deployment Group Job
• 展开「Deployment group」配置区域，找到「Requirements」设置项
• 将默认的All targets must satisfy the requirements（所有目标必须满足要求），修改为At least N targets must satisfy the requirements（至少N台目标满足要求），把N设置为你需要保证的最小在线机器数量（比如1，只要有一台在线就继续部署）
• 如果你的机器是按标签分组管理的，也可以先给在线机器打专属标签（比如online-prod），然后设置要求为Targets with the specified tags，再配合「至少N台」的规则，精准筛选在线目标

2. 启用跳过不可用代理的选项

• 在Deployment Group Job的「Advanced」（高级）配置区域，找到Skip machines with unavailable agents选项并勾选
• 这个配置会让Azure DevOps自动跳过代理离线的机器，只将部署任务分发到在线可用的机器上，不会因部分机器离线中断整个发布流程

变通方案（复杂场景适用） #

如果内置配置无法满足你的自定义需求，可以通过脚本动态筛选在线机器：

• 添加一个PowerShell任务，调用Azure DevOps的REST API查询目标部署组的机器状态，筛选出代理在线的机器ID列表
• 将筛选后的机器ID作为参数传递给后续的部署任务，实现仅部署到在线机器的效果
• 示例脚本逻辑：

  # 调用API获取部署组机器列表
  $machines = Invoke-RestMethod -Uri "$(System.TeamFoundationCollectionUri)$(System.TeamProject)/_apis/distributedtask/deploymentgroups/{deploymentGroupId}/machines?api-version=7.1-preview.1" -Headers @{Authorization = "Bearer $(System.AccessToken)"}
  # 筛选在线机器（agentStatus为online）
  $onlineMachineIds = $machines.value | Where-Object {$_.agentStatus -eq "online"} | Select-Object -ExpandProperty id
  # 将结果设置为管道变量
  Write-Host "##vso[task.setvariable variable=OnlineMachineIds]$($onlineMachineIds -join ',')"
  

• 后续部署任务中，在「Deployment group」的「Machines」选项里选择「Machine IDs」，并填入变量$(OnlineMachineIds)

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