Azure DevOps YAML管道中JSON变量适配ADF ARM部署参数的问题

问题根源 #

Azure DevOps管道变量默认以字符串类型存储，而ARM模板中对应参数要求JSON对象/数组类型，直接传递会引发类型校验失败。

解决方案 #

方案1：PowerShell脚本内转换参数类型 #

在AzurePowerShell@5任务的执行脚本中，先将字符串变量转换为JSON对象，再通过-TemplateParameterObject传递给部署命令，避免字符串类型冲突。

示例代码：

# 读取变量组中的JSON字符串
$scheduleRaw = "$(YourScheduleVariable)"

# 转换为JSON对象
$scheduleObj = $scheduleRaw | ConvertFrom-Json

# 组装所有模板参数
$deploymentParams = @{
    ResourceGroupName = "your-resource-group"
    TemplateFile = "$(System.DefaultWorkingDirectory)/path/to/adf-template.json"
    # 映射ARM模板参数到转换后的JSON对象
    ScheduleParameter = $scheduleObj
    # 添加其他需要覆盖的参数...
}

# 执行部署
New-AzResourceGroupDeployment @deploymentParams

方案2：生成临时参数文件部署 #

如果更倾向于使用参数文件模式，可以将变量内容写入临时JSON参数文件，再让部署命令读取该文件：

示例代码：

# 构建临时参数文件内容
$paramContent = @"
{
    "`$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "ScheduleParameter": $(YourScheduleVariable)
    }
}
"@

# 保存到临时文件
$tempParamPath = Join-Path $env:BUILD_ARTIFACTSTAGINGDIRECTORY "adf-temp-params.json"
$paramContent | Out-File -Path $tempParamPath -Encoding UTF8

# 执行部署
New-AzResourceGroupDeployment -ResourceGroupName "your-resource-group" `
    -TemplateFile "$(System.DefaultWorkingDirectory)/path/to/adf-template.json" `
    -TemplateParameterFile $tempParamPath

关键注意点 #

• 确认变量组中的JSON格式完全合法：比如"minutes":[00]需注意，若ARM模板期望数字数组，00会被解析为0；若期望字符串数组，需改为["00"]。
• 若变量中包含特殊字符或双引号，确保Azure DevOps变量组内的内容已正确转义（直接写入标准JSON格式即可，无需额外转义）。

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