导入ARM JSON后Azure DevOps发布管道代理池空白，如何自动修复？

问题描述 #

从ARM JSON文件导入Azure DevOps发布管道后，发布管道中的“Agent Pool（代理池）”设置始终显示空白，需手动修复。相关ARM JSON片段如下：

..,"deployPhases" : [
  { "deploymentInput" : {
      "parallelExecution" : { "parallelExecutionType" : "none" },
      "agentSpecification" : null,
      "skipArtifactsDownload" : false,
      "artifactsDownloadInput" : {},
      "queueId" : 456,
      "demands" : [],
      "enableAccessToken" : false,
      "timeoutInMinutes" : 0,
      "jobCancelTimeoutInMinutes" : 1,
      "condition" : "succeeded()",
      "overrideInputs" : {}
    },
    "rank"          : 1,
    "phaseType"     : "agentBasedDeployment",
    "name"          : "DEV Agent Job",
    "refName"       : null,
    "workflowTasks" : [..]
  }
], ..

尝试设置agentSpecification为{ "identifier" : "windows-2019" }无效，调用API https://dev.azure.com/{org}/{proj}/_apis/distributedtask/queues获取到PoolID为456、QueueID为123，使用两个ID均未解决问题。

解决方案 #

多个用户曾遇到同类问题，通常是JSON结构缺失关键字段或ID混淆导致，可通过以下步骤解决：

• 修正queueId的取值
  API返回的QueueID（即队列自身的id字段，示例中为123）才是queueId应填的值，而非代理池的poolId（456）。将JSON中的queueId改为队列ID：

  "queueId": 123
  

• 添加完整的pool节点引用
  仅设置queueId可能不足以让Azure DevOps正确关联代理池，需在deploymentInput中添加pool对象，明确代理池的ID和名称：

  "deploymentInput": {
    // 其他字段保持不变
    "queueId": 123,
    "pool": {
      "id": 456,
      "name": "你的代理池名称"
    },
    // 其他字段保持不变
  }
  

• 参考官方导出的管道JSON结构
  手动创建一个配置好代理池的发布管道，调用API导出其完整JSON结构：

  GET https://dev.azure.com/{org}/{proj}/_apis/release/definitions/{definitionId}?api-version=7.1-preview.7
  

  对比导出的deployPhases部分与自己的ARM JSON，补全缺失的必填字段（如agentSpecification的完整配置、pool节点等）。

• 验证代理池和队列的权限
  确保导入管道的账号拥有目标代理池和队列的访问权限，权限不足也可能导致导入后代理池无法正常显示。

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