调用指定版本Terraform模块时Terragrunt要求不存在的变量

以下是针对问题的具体排查步骤：

1. 确认模块引用的版本正确性 #

• 检查Git标签拼写：在infrastructure-modules仓库执行git tag -l列出所有标签，确认v.0.0.13标签是否存在，是否有拼写错误（比如是否应为v0.0.13，和v0.1.0格式统一）。
• 手动验证模块版本内容：本地克隆模块仓库并切换到指定标签，确认代码中确实无private_ips变量：

  git clone <你的infrastructure-modules仓库地址> temp-modules
  cd temp-modules
  git checkout v.0.0.13
  grep -r "private_ips" .
  

  若输出为空，说明该版本确实无此变量；若有结果，说明标签关联的代码有误，需重新打标签。
• 检查本地模块目录状态：你使用的是相对路径../../../modules-ref//REDACTED-ec2，确认modules-ref/REDACTED-ec2目录的当前Git状态：

  cd ../../../modules-ref/REDACTED-ec2
  git status
  git log --oneline -n 1
  

  确保当前分支/标签是v.0.0.13，而非意外切换到了v0.1.0或其他包含private_ips的版本。

2. 清理Terragrunt缓存 #

Terragrunt会将模块缓存到.terragrunt-cache目录，旧缓存可能导致异常：

• 本地环境：删除当前工作目录下的.terragrunt-cache文件夹，重新执行terragrunt plan。
• GitLab流水线：在流水线脚本中添加清理步骤，确保每次运行都是全新环境：

  rm -rf .terragrunt-cache
  

3. 排查根配置或父级配置的干扰 #

你使用了include "root"引用父级配置，检查根目录的terragrunt.hcl：

• 是否存在全局terraform.source配置，覆盖了当前模块的版本指定？
• 是否有generate块生成了额外变量定义，或dependency块引入了其他版本的模块？
• 检查所有父级Terragrunt配置文件，确认无变量传递或模块引用冲突。

4. 验证工具版本一致性 #

确认GitLab流水线中使用的Terraform和Terragrunt版本，与本地测试版本一致：

• 执行terraform version和terragrunt version对比本地与流水线的版本。
• 部分旧版本Terragrunt在解析模块版本时存在bug，尝试升级到稳定版本后重试。

5. 检查模块是否有隐藏依赖 #

查看v.0.0.13版本模块下所有.tf文件，确认是否存在子模块引用：

grep -r "module " temp-modules/

若存在子模块，检查子模块版本是否引入了private_ips变量。

内容的提问来源于stack exchange，提问作者A. Kendall