Terraspace全局tfvars未用变量过滤功能咨询

现有可行方案 #

1. 按栈拆分全局tfvars目录结构

你可以在全局tfvars目录下，为每个栈创建专属子目录，比如：

/configuration/terraform/
├── base.tfvars          # 所有栈共享的变量
└── stacks/
    ├── stack-1/
    │   └── dev.tfvars   # stack-1专属变量
    ├── stack-2/
    │   └── dev.tfvars   # stack-2专属变量
    ...

Terraspace会自动合并全局base.tfvars和对应栈子目录下的环境tfvars，这样每个栈只会加载自身需要的变量，从根源减少未用变量的情况。

2. 自定义Build钩子实现变量过滤

Terraspace支持通过config/app.rb中的构建钩子，在栈生成后自动过滤未使用的变量，具体实现如下：

Terraspace.build do
  after_build do |mod|
    # 提取当前栈所有定义的变量名
    declared_vars = []
    Dir.glob("#{mod.root}/**/*.tf").each do |tf_file|
      content = File.read(tf_file)
      # 匹配variable块中的变量名（兼容基础定义格式）
      declared_vars += content.scan(/^\s*variable\s+"([^"]+)"\s*{/).flatten
    end
    declared_vars.uniq!

    # 读取全局环境tfvars
    global_tfvar_path = "/configuration/terraform/#{Terraspace.env}.tfvars"
    next unless File.exist?(global_tfvar_path)

    # 解析全局tfvars为Hash
    global_vars = Terraspace::Tfvar.new(global_tfvar_path).to_h
    # 过滤出当前栈声明的变量
    filtered_vars = global_vars.slice(*declared_vars)

    # 覆盖生成的栈tfvars文件
    target_tfvar_path = "#{mod.cache_path}/tfvars/#{Terraspace.env}.tfvars"
    File.write(target_tfvar_path, filtered_vars.to_hcl)
  end
end

这个钩子会在每个栈构建完成后，自动读取当前栈的Terraform变量定义，过滤全局tfvars中未被使用的变量，重新生成仅包含所需变量的tfvars文件，彻底消除未用变量警告。

官方功能规划 #

目前Terraspace官方尚未提供专门的“seed”式变量过滤功能，但社区已有相关需求反馈，官方在GitHub议题中也有讨论，后续版本可能会推出更便捷的内置筛选机制，比如支持在tfvars中通过标签指定变量所属栈，或者提供原生的变量过滤函数。

额外提示 #

如果只是临时抑制警告，可以设置环境变量TF_IN_AUTOMATION=1，但这只是隐藏警告而非解决根源问题，更推荐使用上述变量过滤方案。

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