Terragrunt脚手架功能增强：支持自定义输出目录

Terragrunt作为一款优秀的Terraform包装工具，其脚手架(scaffold)功能能够帮助开发者快速生成基础配置文件。然而当前版本存在一个使用痛点——生成的terragrunt.hcl文件只能输出到当前工作目录，无法灵活指定输出位置。

问题背景

在实际项目开发中，特别是采用基础设施即代码(IaC)管理的大型项目，通常会有复杂的目录结构。例如一个典型的多环境部署项目可能采用如下目录层级：

deployments/
├── dev/
│   ├── us-east-1/
│   │   ├── tenant1/
│   │   │   └── vpc/
├── prod/
│   ├── us-west-2/
│   │   ├── tenant2/
│   │   │   └── ecs/

开发者期望在使用terragrunt scaffold命令时，能够直接将配置文件生成到目标目录，而不是先生成在当前目录再手动移动。

现有解决方案分析

目前社区提出了几种可能的解决方案：

1. 依赖Boilerplate的dependencies特性：通过定义依赖关系，尝试将输出重定向到目标目录。但实际测试发现这种方法会导致递归循环问题，无法正常工作。

2. 使用after钩子脚本：在脚手架生成后通过脚本移动文件。这种方法虽然可行，但不够优雅，且增加了额外的维护成本。

3. 直接修改源码添加输出目录参数：这是最彻底的解决方案，但需要开发者具备Go语言开发能力。

技术实现建议

从技术实现角度，最合理的方案是为scaffold命令添加--output-folder参数，保持与Boilerplate工具的一致性。这需要修改以下部分：

1. 命令行参数解析：在cmd/scaffold.go中添加新的flag定义
2. 模板渲染逻辑：修改模板渲染的输出路径处理逻辑
3. 目录创建：确保目标目录存在，若不存在则自动创建
4. 格式化工具体验：保持现有的hclfmt格式化功能在正确目录执行

最佳实践建议

在等待官方实现该功能期间，开发者可以采用以下临时方案：

1. 封装脚本：创建一个包装脚本，先运行scaffold，再移动文件到目标位置
2. 使用Makefile：定义自动化任务处理文件移动和目录创建
3. 模板预处理：在脚手架生成前，先创建好目标目录结构

未来展望

该功能的实现将显著提升Terragrunt在复杂项目中的使用体验，特别是对于以下场景：

• 多环境部署管理
• 多区域基础设施配置
• 租户隔离的SaaS架构
• 大型企业级基础设施代码库

社区维护者已将该功能标记为"preserved"，意味着即使没有外部贡献，最终也会由核心团队实现。对于急需此功能的团队，可以考虑自行实现并向上游提交Pull Request。