Terraform部署Debian VM时azurerm_virtual_machine_extension无法完成

核心排查与解决方向 #

1. 验证Azure Linux Agent兼容性 #

Debian 10/11对Azure VM扩展的依赖要求明确：

• Debian 10需waagent版本≥2.2.45，Debian 11需≥2.2.53
• 登录VM执行waagent --version检查版本，版本过低则执行sudo apt update && sudo apt install -y walinuxagent升级
• 确认Agent服务状态：sudo systemctl status walinuxagent，确保服务正常运行

2. 检查网络与权限配置 #

• 扩展需要VM能访问Azure服务端点（https://management.azure.com、区域Blob存储地址等）：
  • 验证NSG规则是否允许出站HTTPS（443）流量，若使用私有DNS，确保能解析上述Azure域名
• 检查/var/lib/waagent/目录权限，需为root:root，权限异常会导致扩展无法写入日志或执行操作

3. 适配Debian的Terraform扩展配置 #

如果使用自定义脚本扩展，需调整配置适配Debian特性：

• 脚本开头指定兼容的Shell解释器（如#!/bin/bash），避免依赖Ubuntu特有环境
• 修正command_to_execute路径，确保脚本在Debian下可执行，示例配置：

resource "azurerm_virtual_machine_extension" "debian_custom_script" {
  name                 = "debianCustomScript"
  virtual_machine_id   = azurerm_virtual_machine.vm.id
  publisher            = "Microsoft.Azure.Extensions"
  type                 = "CustomScript"
  type_handler_version = "2.1"

  settings = <<SETTINGS
    {
      "fileUris": ["https://your-storage-url/script.sh"],
      "commandToExecute": "sudo bash /tmp/script.sh"
    }
SETTINGS

  timeout_in_minutes = 30
}

4. 通过日志定位具体错误 #

登录Debian VM查看关键日志：

• Azure Agent日志：/var/log/waagent.log，排查Agent与Azure平台的通信问题
• 扩展专属日志：/var/log/azure/<扩展名称>/<版本号>/extension.log，定位脚本执行或包下载失败原因

5. 确认镜像合法性 #

• 确保使用Azure官方Debian镜像（publisher为Debian，SKU如11-gen2），自定义镜像可能缺失Agent或必要系统组件，导致扩展无法运行

内容的提问来源于stack exchange，提问作者Javier García Aguilera