用途:生成生产可用的 Terragrunt 配置,遵循命名约定与安全标准,并在生成后自动校验。
主要能力:支持 Terragrunt 2025 特性,包括 Stacks(terragrunt.stack.hcl,v0.78.0 起 GA)、Feature Flags、Exclude Blocks(替代已弃用的 skip)、Errors Blocks(替代已弃用的 retryable_errors)以及 OpenTofu 引擎。可生成根配置、子模块配置、独立模块、多环境基础设施、Stacks、Feature Flags、Exclude/Errors 块与 OpenTofu 引擎配置。根文件推荐使用 root.hcl 而非 terragrunt.hcl。
架构模式:Pattern A 多环境 + 环境无关根配置(root.hcl 不读取 env.hcl);Pattern B 单环境或环境感知根配置;Pattern C 通过 _env 目录集中环境变量。生成前必须确定并输出架构模式检查清单。
使用方式:按工作流先理解需求、确定架构模式、读取对应模板(如 assets/templates/root/terragrunt.hcl、child、module、stack、catalog),再生成并做内联检查,最后批量校验。常用命令包括 terragrunt hcl fmt --check、terragrunt dag graph、terragrunt stack generate、terragrunt stack run plan/apply、terragrunt stack output、terragrunt stack clean,以及 terragrunt run --all init/plan/apply/destroy。Feature Flag 默认值必须为静态值,不能引用 local.*,可通过 --feature 或 TG_FEATURE 覆盖。
适用场景:新建 Terragrunt 项目、多环境基础设施、DRY Terraform 配置、带依赖的复杂基础设施、自定义 provider 或模块。
限制:完整 CLI 校验需所有文件存在,故批量执行;校验失败需修复并重新校验。资料未提供具体收费、价格与平台支持信息。