为何需在Terragrunt环境variables.tf中声明模块变量？

1. 为什么环境目录需要重复声明模块变量？ #

这是Terraform + Terragrunt的工作机制导致的：

• 每个环境目录（dev/prd）对Terraform来说是独立的工作目录，Terragrunt会在该目录下生成临时Terraform配置并执行。
• 当你在环境的terragrunt.hcl中通过inputs传递变量给VPC模块时，这些变量本质是当前工作目录的输入变量，Terraform要求当前目录必须显式声明这些变量（哪怕只是直接传递给子模块）——它会先验证当前配置的变量定义，再将变量值传递给模块。
• 如果你不在环境目录的variables.tf中声明这些变量，Terraform会认为你在引用未定义的变量，因此抛出错误。

2. 符合DRY原则的优化方案 #

重复定义变量确实违反DRY，推荐以下两种可维护方案：

方案一：用Terragrunt的generate块自动生成variables.tf #

在根目录的root_terragrunt.hcl中添加generate块，自动从VPC模块中导出变量定义到环境目录的variables.tf，无需手动复制：

generate "variables" {
  path      = "variables.tf"
  if_exists = "overwrite"

  contents = templatefile("${get_parent_terragrunt_dir()}/templates/variables.tpl", {
    module_vars = get_module_variables("../../modules/vpc")
  })
}

然后在根目录创建templates/variables.tpl模板文件：

% for name, var in module_vars ~%
variable "${name}" {
  type        = ${jsonencode(var.type)}
  description = "${var.description != "" ? var.description : "No description provided"}"
  % if var.default != null ~%
  default     = ${jsonencode(var.default)}
  % endif ~%
}
% endfor ~%

这个方案会自动遍历VPC模块的所有变量，生成对应的variables.tf内容，完全避免手动维护。

方案二：在环境目录直接调用模块，减少变量传递层级 #

调整目录结构，在每个环境目录的main.tf中直接调用VPC模块：

# dev/main.tf
module "vpc" {
  source = "../../modules/vpc"

  vpc_cidr          = var.vpc_cidr
  public_subnet_cidrs = var.public_subnet_cidrs
  # 其他模块变量
}

然后在环境目录的variables.tf中只声明环境差异化的变量（比如dev和prd不同的CIDR），公共变量直接在模块中设置默认值，或者通过Terragrunt的inputs从根目录传递：

# root_terragrunt.hcl
inputs = {
  # 公共默认变量
  enable_nat_gateway = true
}

# dev/terragrunt.hcl
inputs = merge(
  get_terragrunt_config(find_in_parent_folders()).inputs,
  {
    # 环境差异化变量
    vpc_cidr = "10.0.0.0/16"
  }
)

这种方式减少了变量传递的中间层，只需要维护环境特有的变量，公共变量要么在模块设默认，要么在根目录统一配置。

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