GCP Terraform compute模块resource_policy time_zone未声明报错

构建第0步抛出错误：main.tf第116行的google_compute_resource_policy "hourly"资源中，配置项time_zone = var.time_zone存在问题：引用了未声明的输入变量time_zone，系统提示可通过variable "time_zone" {}块声明该变量。多次调整变量声明块放置位置后报错仍复现。

排查思路（按触发概率从高到低排序） #

• 优先确认变量声明的文件归属：Terraform和Terragrunt的变量体系完全独立，Terraform只会解析执行目录下所有.tf后缀文件内的variable块，写在terragrunt.hcl里的Terraform原生变量块不会被Terraform识别。不要把variable "time_zone" {}写在Terragrunt配置文件中，必须放在对应Terraform模块目录下的.tf文件内（Terraform不限制variable块所在的tf文件名，main.tf、variables.tf均可识别）。
• 检查CloudBuild执行的工作目录匹配性：构建第0步就抛出语法校验错误，大概率是执行Terraform/Terragrunt命令的工作目录下，根本没有包含你写了time_zone变量声明的tf文件。可以在CloudBuild报错步骤前新增两步调试命令确认文件加载情况：

  # 打印当前工作目录下所有文件
  ls -la
  # 全局搜索当前构建环境内的time_zone变量声明
  find . -name "*.tf" | xargs grep -n "variable \"time_zone\""
  

  如果搜索不到对应声明，说明CloudBuild的dir配置错误，或者你把变量文件存到了命令执行范围外的目录。
• 检查变量块的语法与拼写正确性：Terraform对变量名、块结构是强校验的，以下错误都会导致变量识别失败：
  • 变量名拼写偏差：比如把time_zone写成timezone、time-zone，和资源中引用的名称不完全匹配
  • 块结构缺失：漏写大括号、参数写在块外，导致Terraform解析时不认为这是合法的variable块
  • 变量块被注释：不小心把整个variable块包裹在/* */多行注释或者#单行注释内，解析时直接被跳过
    合法的最小变量声明块参考如下：

  variable "time_zone" {
    type        = string
    description = "VM启停调度所属时区，例：Asia/Shanghai"
    default     = "UTC"
  }
  

• 检查模块作用域与缓存问题：
  • Terraform变量是模块级作用域，如果google_compute_resource_policy资源定义在子模块内，对应的variable "time_zone"必须声明在同一个子模块的tf文件中，根模块声明的变量不会自动透传到子模块
  • 如果是通过module块引用封装好的调度模块，先清理构建环境内的.terraform、.terragrunt-cache缓存目录，避免CloudBuild拉取到旧版本、未添加time_zone变量的模块缓存，同时确认module块的source路径指向正确的最新模块版本。

对应修复方案 #

• 若变量写在Terragrunt配置中：将variable "time_zone"块移到对应Terraform模块的.tf文件内，在Terragrunt配置中通过inputs块传值即可：

  # terragrunt.hcl 内传值示例
  inputs = {
    time_zone = "Asia/Shanghai"
    # 其余VM调度相关参数
  }
  

• 若CloudBuild工作目录不匹配：修改cloudbuild.yaml中对应构建步骤的dir字段，指向包含完整tf配置的执行目录，保证命令执行时能加载到所有变量声明文件。
• 若存在语法/拼写/注释问题：修正variable块结构，保证变量名和资源内引用的var.time_zone完全一致，移除变量块外的注释标记。
• 若为作用域/缓存问题：在资源所属的子模块内补全time_zone变量声明，构建前执行缓存清理命令，修正模块source路径确保拉取最新代码，上层模块调用时显式传入time_zone参数值。

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