Azure Terraform部署带托管数据盘的Linux VM挂载循环问题

问题概述 #

现有Terraform模块可正常部署仅带系统盘的Linux VM，但扩展添加附加托管数据盘时，挂载数据盘的步骤持续报错，无法正确关联VM ID。

错误核心原因 #

核心问题在于数据盘挂载资源的索引逻辑不匹配：

• azurerm_linux_virtual_machine.vm 通过for_each = var.virtual_machines创建，其键是VM的标识（如测试配置中的linux-001）
• azurerm_virtual_machine_data_disk_attachment.data_disk_attach 通过for_each = var.data_disks创建，其键是数据盘的名称（如data-disk-001）
• 尝试用数据盘的键（each.key）去索引VM资源，自然找不到对应条目，因为两者的键空间完全不匹配

其他尝试的错误点：

• vm[0].id：VM资源是map类型（由for_each生成），只能用字符串键索引，不能用数字索引
• vm[*].id：这会返回所有VM ID的列表，但virtual_machine_id要求单个字符串值，类型不匹配

解决方案 #

根据模块设计合理性，推荐两种修正方案：

方案1：将数据盘关联到单个VM（符合资源归属逻辑） #

调整模块设计，把数据盘配置嵌入到每个VM的定义中，让数据盘明确属于某个VM，挂载时直接使用VM的键索引。

1. 修改virtual_machines变量定义

在VM对象中添加data_disks字段：

variable "virtual_machines" {
  type = map(object({
    name                = string
    computer_name       = string
    os_disk             = list(object({
      name                 = string
      caching              = string
      storage_account_type = string
      disk_size_gb         = number
    }))
    source_image_reference = list(object({
      publisher = string
      offer     = string
      sku       = string
      version   = string
    }))
    nic_name           = string
    ip_configuration   = object({
      name                          = string
      subnet_id                     = string
      private_ip_address_allocation = string
      private_ip_address            = optional(string)
    })
    data_disks = optional(list(object({
      name                 = string
      caching              = string
      storage_account_type = string
      disk_size_gb         = number
      lun                  = number
    })), [])
  }))
  description = "Configuration for Linux virtual machines"
}

2. 调整数据盘及挂载资源代码

删除原有的var.data_disks变量，修改数据盘和挂载资源的for_each逻辑：

# 数据盘：基于每个VM下的data_disks配置
resource "azurerm_managed_disk" "disk" {
  for_each = flatten([
    for vm_key, vm in var.virtual_machines : [
      for disk in vm.data_disks : {
        key = "${vm_key}-${disk.name}"
        vm_key = vm_key
        disk_config = disk
      }
    ]
  ])

  name                 = each.value.disk_config.name
  location             = var.location
  resource_group_name  = var.resource_group_name
  create_option        = "Empty"
  storage_account_type = each.value.disk_config.storage_account_type
  disk_size_gb         = each.value.disk_config.disk_size_gb
}

# 数据盘挂载：关联到对应的VM
resource "azurerm_virtual_machine_data_disk_attachment" "data_disk_attach" {
  for_each = azurerm_managed_disk.disk

  managed_disk_id    = each.value.id
  virtual_machine_id = azurerm_linux_virtual_machine.vm[each.value.vm_key].id
  lun                = each.value.disk_config.lun
  caching            = each.value.disk_config.caching
}

3. 更新测试配置

将数据盘配置移到virtual_machines的对应VM下：

module "linux_vm" {
  source = "../"

  # 其他参数保持不变...

  virtual_machines = {
    "linux-001" = {
      name          = "linux-001"
      computer_name = "linux-001"
      # os_disk、source_image_reference、nic_name、ip_configuration保持不变...
      
      data_disks = [
        {
          name                 = "data-disk-001"
          caching              = "ReadWrite"
          storage_account_type = "StandardSSD_LRS"
          disk_size_gb         = 128
          lun                  = 5
        }
      ]
    }
  }
}

方案2：保持原有变量结构（快速临时修复） #

如果不想调整模块结构，可通过以下方式修复：

方式A：为数据盘添加VM键字段

修改var.data_disks定义，增加vm_key字段指定挂载目标VM：

variable "data_disks" {
  type = list(object({
    name                 = string
    caching              = string
    storage_account_type = string
    disk_size_gb         = number
    lun                  = number
    vm_key               = string # 添加此字段，指定VM的键
  }))
  description = "(Optional) Values for any additional data disks"
}

修改挂载资源的virtual_machine_id：

resource "azurerm_virtual_machine_data_disk_attachment" "data_disk_attach" {
  for_each = {
    for index, data_disk in var.data_disks : data_disk.name => data_disk
  }

  managed_disk_id    = azurerm_managed_disk.disk[each.key].id
  virtual_machine_id = azurerm_linux_virtual_machine.vm[each.value.vm_key].id
  lun                = each.value.lun
  caching            = each.value.caching
}

测试配置中更新数据盘：

data_disks = [
  {
    name                 = "data-disk-001"
    caching              = "ReadWrite"
    storage_account_type = "StandardSSD_LRS"
    disk_size_gb         = 128
    lun                  = 5
    vm_key               = "linux-001" # 指定要挂载的VM键
  }
]

方式B：仅部署单个VM场景

直接取VM资源的第一个值：

resource "azurerm_virtual_machine_data_disk_attachment" "data_disk_attach" {
  for_each = {
    for index, data_disk in var.data_disks : data_disk.name => data_disk
  }

  managed_disk_id    = azurerm_managed_disk.disk[each.key].id
  virtual_machine_id = values(azurerm_linux_virtual_machine.vm)[0].id
  lun                = each.value.lun
  caching            = each.value.caching
}

总结 #

方案1是更规范的Terraform模块设计，符合资源归属关系，支持多VM场景；方案2适合快速修复现有代码，适用于单VM或明确指定挂载目标的场景。

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