如何在AzureResourceManagerTemplateDeployment@3任务中覆写嵌套ARM参数

我正在通过Azure DevOps（AZDO）流水线使用ARM模板部署虚拟机，为了简化参数文件，将原本分散的顶层参数改为嵌套JSON对象格式，参数文件示例如下：

{
 "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
 "contentVersion": "1.0.0.0",
 "parameters": {
     "config": {
         "location": "eastus",
         "extensions": {
             "extension1": {
                 "apiKey": ""
             }
         }
     }
 }
}

部分虚拟机扩展需要敏感信息（如apiKey）配置，若apiKey是顶层参数，我可以通过Key Vault中的密钥在流水线任务里这样覆写：

- task: AzureResourceManagerTemplateDeployment@3
 inputs:
   overrideParameters: '-apiKey $(extension1APIKey)'

但现在apiKey嵌套在多层属性中，我尝试用以下方式覆写，想确认是否正确：

- task: AzureResourceManagerTemplateDeployment@3
 inputs:
   overrideParameters: '-config.extensions.extension1.apiKey $(extension1APIKey)'

若不正确，请问覆写嵌套属性/参数的正确方法是什么？

解答 #

你尝试的点符号语法-config.extensions.extension1.apiKey $(extension1APIKey)是正确的，Azure Resource Manager模板部署任务支持通过点路径来覆写嵌套参数的属性值。

需要注意两个前提条件：

• ARM模板中，config参数必须定义为object类型，并且模板内要正确引用嵌套属性，比如使用[parameters('config').extensions.extension1.apiKey]来获取值，这样流水线的覆写才能生效。
• 确保流水线已经通过Key Vault任务正确获取到$(extension1APIKey)变量，且当前任务有访问该变量的权限。

如果点语法遇到兼容性问题，还可以采用直接传递完整嵌套对象的方式，把需要修改的属性包含进去，示例如下：

- task: AzureResourceManagerTemplateDeployment@3
  inputs:
    overrideParameters: '-config {"location": "eastus", "extensions": {"extension1": {"apiKey": "$(extension1APIKey)"}}}'

这种方式适合需要同时修改多个嵌套属性的场景，但要注意JSON格式的转义，保证语法无错误。

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