Terragrunt CLI 重构：更简洁高效的基础设施管理体验

Terragrunt 作为 Terraform 的包装工具，近期对其命令行界面（CLI）进行了重大重构。这次重构旨在解决长期存在的用户体验问题，使工具更加直观易用。本文将详细介绍这些改进及其对用户工作流的影响。

核心改进内容

1. 命令结构优化

重构后的 CLI 采用了更清晰的命令层级结构：

• run：专门用于执行 Terraform/OpenTofu 命令
• exec：执行任意系统命令
• info：查询 Terragrunt 状态信息
• init：初始化后端配置

这种结构消除了原有命令的歧义性，使功能划分更加明确。例如，现在可以通过 terragrunt run plan 直接执行 Terraform 计划，而无需记忆复杂的命令组合。

2. 标志命名简化

移除了所有标志中的 "terragrunt" 前缀，使命令更加简洁。例如：

• --terragrunt-iam-role 简化为 --iam-assume-role
• --terragrunt-log-level 简化为 --log-level

这种改变不仅减少了输入量，还使命令更符合 CLI 工具的通用设计规范。

3. 后端初始化流程改进

重构后的初始化流程更加直观：

1. 显式使用 terragrunt init 初始化后端
2. 后续命令自动使用已初始化的后端配置

这解决了原有隐式初始化带来的困惑，使整个工作流程更加透明。

技术实现细节

参数传递机制

引入了标准的 -- 分隔符来区分 Terragrunt 标志和目标命令标志。例如：

terragrunt run -- -var-file=prod.tfvars plan

这种机制与许多其他 CLI 工具（如 aws-vault）保持一致，提高了与其他工具的兼容性。

向后兼容性

重构采用了分阶段迁移策略：

1. 首先引入新命令同时保留旧命令
2. 逐步将旧命令标记为弃用
3. 最终在后续版本中移除旧命令

这种渐进式改进确保现有自动化脚本不会突然中断。

用户价值

1. 学习曲线降低：新用户不再需要记忆复杂的命令结构
2. 工作效率提升：更短的命令和更直观的工作流减少了输入错误
3. 调试更简单：清晰的命令层级使问题定位更加容易
4. 脚本维护简化：标准化的参数传递机制提高了脚本的可读性

最佳实践建议

1. 新项目应直接采用新 CLI 结构
2. 现有项目可以逐步迁移，利用过渡期测试兼容性
3. 自动化脚本应考虑添加 -- 分隔符以提高可维护性
4. 关注后续版本公告，及时更新将被移除的旧命令

这次 CLI 重构标志着 Terragrunt 在成熟度上的重要进步，使其在保持强大功能的同时，提供了更加优雅的用户体验。对于基础设施即代码实践者来说，这些改进将显著提升日常工作的效率和愉悦度。