Azure DevOps如何将变量组数组传递给ARM模板且避免转义问题

你的问题本质是Azure DevOps变量组存储字符串类型值时，默认会对双引号做自动转义，导致JSON格式的数组内容出现多余的反斜杠，手动替换转义符的方式容易出现边界异常（比如配置项含特殊字符时出错），可选用以下更稳定的方案：

方案1：部署时直接用管道内置JSON函数解析 #

不需要修改现有变量组配置，只需在Azure CLI部署任务的传参环节调用DevOps内置的JSON解析函数即可自动处理转义：

1. 首先确认ARM模板中对应参数定义为array类型：

{
  "parameters": {
    "cosmosDbConfigs": {
      "type": "array",
      "metadata": {
        "description": "Cosmos DB数据库配置列表，包含库名和吞吐量"
      }
    }
  }
}

2. 在Azure CLI部署命令中直接用$[json()]表达式解析变量组的配置字符串：

az deployment group create \
  --resource-group <你的资源组名称> \
  --template-file ./cosmosdb-deploy.json \
  --parameters cosmosDbConfigs="$[json(variables.cosmosDbConfigStr)]"

其中cosmosDbConfigStr是你变量组中存储数组JSON的变量名，整个解析过程由DevOps原生支持，不会产生额外转义。

方案2：流水线预生成参数JSON文件 #

如果你的部署逻辑依赖独立的参数JSON文件，可以加一个前置任务直接把变量组内容写入参数文件，比手动替换转义符更稳定：

Bash 环境写法 #

# 读取变量组配置写入参数文件
cat > azuredeploy.parameters.json << EOF
{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "cosmosDbConfigs": {
      "value": $COSMOS_DB_CONFIG_STR
    }
  }
}
EOF

PowerShell 环境写法 #

# 解析变量组的JSON字符串为对象，写入参数模板
$paramObj = Get-Content ./azuredeploy.parameters.template.json | ConvertFrom-Json
$paramObj.parameters.cosmosDbConfigs.value = $env:COSMOS_DB_CONFIG_STR | ConvertFrom-Json
$paramObj | ConvertTo-Json -Depth 10 | Out-File ./azuredeploy.parameters.json -Encoding utf8

两种写法都直接用原生JSON序列化能力处理格式，完全避免转义符手动处理的异常风险。

方案3：用变量组的object类型变量（仅YAML管道支持） #

如果你的管道是YAML格式，还可以直接在变量组中定义object类型的变量，不需要存为字符串：

variables:
- group: cosmosDbConfigs
- name: cosmosDbConfigs
  value:
    - name: DB1
      throughput: 400
    - name: DB2
      throughput: 400

传参时直接用convertToJson函数序列化即可：

az deployment group create \
  --resource-group <你的资源组名称> \
  --template-file ./cosmosdb-deploy.json \
  --parameters cosmosDbConfigs='${{ convertToJson(variables.cosmosDbConfigs) }}'

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