使用Ansible为Azure VM添加Custom Script Extension报错求助

看起来你遇到的问题是因为Custom Script Extension的配置结构不符合Azure ARM API的要求——错误提示明确指出properties.template.publisher这个路径不存在，说明你把publisher字段放错了位置。

错误原因分析 #

Azure的Custom Script Extension（以及其他VM扩展）的配置中，publisher是扩展本身的核心属性，应该直接放在扩展的properties节点下，而不是嵌套在template节点里。你的配置里错误地将这个字段放到了template层级，导致Azure API无法解析请求内容。

正确的配置示例 #

如果你用Ansible的azure_rm_virtualmachineextension模块部署

直接在模块参数中指定publisher等核心属性，不要嵌套到settings或其他子节点：

- name: Deploy Custom Script Extension to Azure VM
  hosts: localhost
  gather_facts: false
  tasks:
    - name: Install Custom Script Extension
      azure_rm_virtualmachineextension:
        resource_group: your_resource_group_name
        vm_name: your_vm_name
        name: CustomScriptExtension
        # 正确的publisher位置：模块顶级参数
        publisher: Microsoft.Compute
        virtual_machine_extension_type: CustomScriptExtension
        type_handler_version: '1.10'
        auto_upgrade_minor_version: true
        settings:
          fileUris:
            - "https://your-storage-account.blob.core.windows.net/scripts/bootstrap.ps1"
          commandToExecute: "powershell -ExecutionPolicy Unrestricted -File bootstrap.ps1"

如果你用JSON模板（extension.json）部署

确保publisher字段在扩展的properties节点下，而非template节点：

{
  "name": "CustomScriptExtension",
  "type": "Microsoft.Compute/virtualMachines/extensions",
  "apiVersion": "2023-07-01",
  "location": "your_vm_location",
  "properties": {
    // publisher直接在这里定义
    "publisher": "Microsoft.Compute",
    "type": "CustomScriptExtension",
    "typeHandlerVersion": "1.10",
    "autoUpgradeMinorVersion": true,
    "settings": {
      "fileUris": ["https://your-storage-account.blob.core.windows.net/scripts/bootstrap.ps1"],
      "commandToExecute": "powershell -ExecutionPolicy Unrestricted -File bootstrap.ps1"
    }
  }
}

额外检查点 #

1. 确认你的Ansible模块版本是最新的，旧版本的azure_rm_virtualmachineextension可能存在参数结构问题；
2. 检查JSON/YAML的语法是否正确，比如有没有多余的逗号、括号不匹配的情况，这类语法错误也可能导致Azure API解析失败；
3. 确保type_handler_version使用的是Azure支持的版本（目前1.10是稳定可用的版本）。

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