Terragrunt v0.73.0 发布：CLI 重新设计与重大改进

Terragrunt 是一个流行的基础设施即代码(IaC)工具，作为 Terraform/OpenTofu 的包装器，提供了更高级的配置管理和工作流自动化能力。最新发布的 v0.73.0 版本带来了多项重大改进，特别是对命令行界面(CLI)的重新设计，标志着该项目向更清晰、更一致的用户体验迈出了重要一步。

CLI 重新设计核心变更

本次版本最引人注目的变化是对 Terragrunt CLI 的全面重新设计，主要体现在以下几个方面：

1. 命令行标志简化

所有 Terragrunt CLI 标志移除了 terragrunt- 前缀，使命令更加简洁。例如，原来的 --terragrunt-config 现在简化为 --config。这一变化不会立即破坏现有工作流，但会开始发出警告提示用户更新。

2. 环境变量前缀变更

所有 Terragrunt 环境变量前缀从 TERRAGRUNT_ 改为更简洁的 TG_。与标志变更类似，这一改动目前不会破坏现有配置，但会发出警告。

3. 默认命令行为的调整

过去，Terragrunt 会将所有未定义的命令直接转发给底层的 OpenTofu/Terraform。v0.73.0 引入了新的 run 命令来明确替代这一行为，使命令执行更加清晰和可控。

新增功能详解

run 命令：更清晰的执行方式

新的 run 命令取代了原来的默认命令行为，为用户提供了更明确的方式来执行 OpenTofu/Terraform 命令。例如：

terragrunt run plan

这种方式使命令意图更加清晰，减少了歧义。未来版本中，run 命令还将整合 run-all 和 graph 的功能，通过 --all 和 --graph 标志来实现。

OpenTofu 快捷命令

为了保持用户体验的连续性，v0.73.0 仍然支持常用的快捷命令，如 terragrunt plan 和 terragrunt apply。这些快捷方式实际上是 run 命令的语法糖，在底层仍然通过 run 命令执行。

exec 命令：扩展执行能力

新增的 exec 命令提供了更灵活的执行能力，允许用户运行任意命令（不限于 OpenTofu/Terraform），同时保持 Terragrunt 的环境配置。这为高级用户提供了更多控制权。

info strict 命令：严格模式信息

新的 info strict 命令让用户能够快速查看可用的严格控制选项，帮助团队更好地理解和采用 Terragrunt 的最佳实践。

迁移建议与兼容性

虽然 v0.73.0 引入了多项破坏性变更，但团队采取了渐进式迁移策略：

1. 所有变更都通过警告而非错误引入，给用户充分的适应时间
2. 提供了严格的模式控制，允许团队按自己的节奏逐步采用新特性
3. 文档中详细说明了迁移路径和替代方案

对于希望立即采用新特性的团队，可以通过严格模式控制来启用这些变更：

• terragrunt-prefix-flags：强制使用无前缀标志
• terragrunt-prefix-env-vars：强制使用新的环境变量前缀
• default-command：禁用默认命令行为

技术影响与最佳实践

这次 CLI 重新设计不仅仅是表面上的变化，它反映了 Terragrunt 项目对清晰性和一致性的追求。从技术角度看，这些变更带来了以下优势：

1. 更清晰的职责划分：run 和 exec 命令明确了不同场景下的执行方式
2. 更好的可维护性：简化的标志和环境变量命名减少了认知负担
3. 更一致的体验：与其他云原生工具保持相似的 CLI 设计模式

对于正在使用 Terragrunt 的团队，建议：

1. 逐步更新脚本和 CI/CD 流水线中的命令格式
2. 利用 info strict 命令评估当前配置的兼容性
3. 在测试环境中验证新版本后再部署到生产环境

总结

Terragrunt v0.73.0 标志着该项目在用户体验和设计一致性方面的重要进步。通过 CLI 重新设计，团队不仅解决了历史遗留的命名问题，还为未来的功能扩展奠定了更坚实的基础。虽然这些变更需要用户进行一定程度的适应，但渐进式的迁移策略和丰富的文档支持使得过渡过程尽可能平滑。

对于基础设施团队而言，现在正是评估和规划迁移到新版本的好时机，以充分利用 Terragrunt 提供的改进功能和更清晰的工作流。