Terraform部署Azure Windows VM扩展遇版本冲突错误求助

问题原因 #

同一虚拟机上已存在一个Microsoft.Compute/CustomScriptExtension扩展，配置为type_handler_version = "1.9"且auto_upgrade_minor_version = false。Azure限制同一类型（发布者+扩展类型）的扩展只能存在一个实例，且当auto_upgrade_minor_version设为false时，扩展版本会被锁定，无法直接修改版本或自动升级配置，导致新扩展部署触发冲突。

解决方案 #

方案1：复用现有扩展 #

如果现有扩展的版本兼容需求，直接修改其配置执行新脚本，无需创建新扩展：

resource "azurerm_virtual_machine_extension" "existing_vmextn" {
    name                 = "旧扩展名称"
    virtual_machine_id   = azurerm_windows_virtual_machine.vm.id
    publisher            = "Microsoft.Compute"
    type                 = "CustomScriptExtension"
    type_handler_version = "1.9"
    auto_upgrade_minor_version = false
    settings             = <<SETTINGS
      {
          "fileUris": ["https://storageforiotscripts.blob.core.windows.net/nodejsscript/installNodeJS.ps1"],
          "commandToExecute": "powershell -ExecutionPolicy Unrestricted -file installNodeJS.ps1"      
      }
  SETTINGS
}

方案2：删除旧扩展后部署新扩展 #

若必须使用新版本或不同自动升级配置，先移除旧扩展再部署新扩展：

1. 在Terraform配置中删除旧扩展的定义，执行terraform apply完成旧扩展删除
2. 部署新扩展配置：

resource "azurerm_virtual_machine_extension" "VMextn1" {
    name                 = "avmextn1"
    virtual_machine_id   = azurerm_windows_virtual_machine.vm.id
    publisher            = "Microsoft.Compute"
    type                 = "CustomScriptExtension"
    type_handler_version = "1.10"
    auto_upgrade_minor_version = true
    settings             = <<SETTINGS
      {
          "fileUris": ["https://storageforiotscripts.blob.core.windows.net/nodejsscript/installNodeJS.ps1"],
          "commandToExecute": "powershell -ExecutionPolicy Unrestricted -file installNodeJS.ps1"      
      }
  SETTINGS
}

方案3：强制更新现有扩展 #

若无法删除旧扩展，可添加force_update_tag参数强制覆盖旧扩展配置（需保证扩展名称与旧扩展一致）：

resource "azurerm_virtual_machine_extension" "VMextn1" {
    name                 = "旧扩展名称"
    virtual_machine_id   = azurerm_windows_virtual_machine.vm.id
    publisher            = "Microsoft.Compute"
    type                 = "CustomScriptExtension"
    type_handler_version = "1.10"
    auto_upgrade_minor_version = true
    force_update_tag     = timestamp() # 用时间戳作为强制更新标记
    settings             = <<SETTINGS
      {
          "fileUris": ["https://storageforiotscripts.blob.core.windows.net/nodejsscript/installNodeJS.ps1"],
          "commandToExecute": "powershell -ExecutionPolicy Unrestricted -file installNodeJS.ps1"      
      }
  SETTINGS
}

关键注意事项 #

• 同一虚拟机上，同一发布者+扩展类型的扩展只能存在一个实例，不能同时部署多个同类型扩展
• auto_upgrade_minor_version设为false后，扩展版本会被锁定，无法直接修改版本，必须删除或强制更新
• 使用force_update_tag时，扩展名称必须与旧扩展完全一致，否则会被识别为新扩展，仍触发冲突

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