Terragrunt项目中Source Map在Stack运行时的兼容性问题解析

问题背景

在Terragrunt的Stack功能使用过程中，开发者发现了一个关于Source Map功能的兼容性问题。具体表现为：当通过terragrunt stack apply命令执行堆栈时，配置在terragrunt.hcl文件中的terraform.source所指定的Source Map不会被正确识别和使用，而同样的配置在使用terragrunt run-all apply时却能正常工作。

技术细节分析

Source Map是Terragrunt提供的一个强大功能，它允许开发者在运行时动态替换模块源地址。这一特性在以下两种场景中特别有用：

1. 本地开发调试时快速切换远程模块和本地修改版本
2. 在不同环境间切换模块源地址

在标准Terragrunt配置中（非Stack模式），Source Map通过terraform.source属性配置，其工作流程如下：

• 解析terraform.source指定的模块路径
• 检查是否配置了Source Map替换规则
• 如果匹配则应用替换

然而在Stack模式下，存在两个层级的源配置：

1. unit.source - 用于定义Stack中各个单元的源位置
2. terraform.source - 单元内部Terragrunt配置中定义的模块源

根据问题描述，Stack模式下的unit.source明确不支持Source Map功能，这是设计使然。但terraform.source本应继续支持Source Map，却在terragrunt stack apply执行时失效。

问题影响范围

该问题主要影响以下使用场景的开发人员：

• 使用Terragrunt Stack功能管理复杂基础设施
• 依赖Source Map功能进行模块源替换
• 习惯使用terragrunt stack apply作为主要工作流

临时解决方案

在官方修复发布前，开发者可以采用以下替代方案：

1. 使用terragrunt stack generate生成配置后，再执行terragrunt run-all apply
2. 直接修改模块源地址而不依赖Source Map功能

问题修复情况

该问题已在Terragrunt v0.75.8版本中得到修复。更新后，terragrunt stack apply命令将能正确识别和处理terraform.source中配置的Source Map规则。

最佳实践建议

对于使用Terragrunt Stack功能的团队，建议：

1. 保持Terragrunt版本更新，确保使用包含修复的版本
2. 对于关键工作流，进行充分测试验证
3. 在CI/CD流水线中明确指定Terragrunt版本
4. 考虑将Source Map配置集中管理，避免分散在多处

总结

Terragrunt作为强大的Terraform包装工具，其Stack功能为管理复杂基础设施提供了更高级的抽象能力。此次发现的Source Map兼容性问题提醒我们，在使用新功能时需要充分理解其设计边界和行为特性。随着项目的持续迭代，这类边界情况将得到更好的处理，为开发者提供更一致的使用体验。