如何将映射展开为Terraform资源/模块的输入参数？

你遇到的问题确实很常见——模块只暴露部分资源参数，每次新增参数都要改模块，既繁琐又违反DRY原则。Terraform完全支持类似Python **kwargs的灵活参数传递方式，具体实现如下：

1. 重构模块变量（vars.tf） #

把原来的单个输入变量替换为一个可自定义的映射变量，默认值留空或包含基础参数，让使用者能自由覆盖或新增参数：

# vars.tf
variable "config" {
  type        = map(any)
  default     = {}
  description = "自定义云资源配置：可覆盖默认参数，也能添加input_3、input_4等资源支持的新参数"
}

如果需要保留类型检查（避免传入不符合要求的参数类型），可以用object类型定义可选属性，兼顾灵活性与类型安全：

# vars.tf（带类型检查的版本）
variable "config" {
  type = object({
    input_1 = optional(string, "foo")
    input_2 = optional(list(string), ["bar"])
    input_3 = optional(string)
    input_4 = optional(list(string))
    # 可根据资源参数继续添加更多可选属性
  })
  default = {}
}

2. 修改模块资源定义（main.tf） #

使用Terraform的参数展开语法（...），将默认参数与用户传入的配置合并后展开为资源的输入参数。用户传入的参数会自动覆盖默认值，新增的参数也会被传递给资源：

# main.tf
resource "cloud_some_resource" "example" {
  # 合并默认参数与用户自定义配置，用户配置优先级更高
  merge(
    {
      input_1 = "foo"
      input_2 = ["bar"]
    },
    var.config
  )...
}

3. 模块使用方式（some_resource.tf） #

使用模块时，只需在config里传递需要修改或新增的参数即可，无需关心模块是否提前声明该参数：

# some_resource.tf
module "mymodule" {
  source = "git::git/mymodule.git"
  config = {
    input_1 = "value"          # 覆盖默认的"foo"
    input_2 = ["other"]        # 覆盖默认的["bar"]
    input_3 = "custom_param"   # 添加资源支持的新参数
    input_4 = ["item1", "item2"] # 添加列表类型的新参数
  }
}

方案优势 #

• 彻底避免了频繁修改模块添加参数的繁琐操作，符合DRY原则
• 使用者可以灵活传递资源支持的任意参数，不受模块原有变量的限制
• 保留默认参数逻辑，用户仅需传递需要调整的部分参数

内容的提问来源于stack exchange，提问作者Guilherme Z. Santos