PROVIDER - Terraform 的 DRY 编排包装器
Terragrunt
Terragrunt 是 Terraform 与 OpenTofu 的 DRY 包装器,用 1 套目录层级收敛后端与 provider 配置,自动处理依赖顺序并支持 run-all 批量执行 20+ 模块;代价是抽象层带来的学习成本与上游版本兼容跟进。
开发工具
美国
Terraform 的 DRY 编排包装器
#基础设施
#IaC
#Terraform
#OpenTofu
#Terragrunt
#多环境管理
#Gruntwork
#DRY配置
#远程状态
#依赖编排
3.8分
详细说明
优势 5 项
作为 Terraform 与 OpenTofu 的包装器,把重复的后端与 provider 配置收敛成 1 份
用 1 套目录层级描述环境与模块关系,自动处理各模块间的依赖顺序
支持生成远程状态与锁配置,让 1 份定义覆盖所有模块的 backend 声明
提供 run-all 命令批量执行 20 个以上模块,并自动推断并行与顺序
由 Gruntwork 维护并开源,Apache 2.0 许可,可商用
不足 4 项
依赖 Terraform 或 OpenTofu 生态,上游版本升级会带来兼容性跟进成本
抽象层增加理解成本,新成员需同时熟悉两套概念
run-all 在大型仓库中容易因部分失败造成状态不一致,需要谨慎编排
官方文档偏工程实践,缺少系统化的入门路径
服务商概述
Terragrunt 是 Gruntwork 开源的 Terraform/OpenTofu 包装工具。它并不替代 Terraform,而是在其之上补充目录组织、配置复用与批量执行能力,解决大型 IaC 仓库中最常见的重复代码问题。
在开发工具分类里,它属于「基础设施即代码」的进阶层:当团队从几个模块扩展到几十个模块、多套环境时,Terragrunt 的价值才明显体现。
核心优势
- DRY 配置:后端、provider 与版本约束集中一份,避免逐模块复制
- 目录即架构:环境与模块关系通过 1 套目录层级表达
- 依赖编排:模块间依赖顺序自动推导,减少手工 apply 顺序错误
- 批量执行:run-all 支持一次处理 20 个以上模块
- 双生态兼容:同时支持 Terraform 与 OpenTofu
产品生态
平台能力
配置继承、远程状态生成、依赖解析、批量运行、hooks 与缓存目录管理。
集成
与 Terraform、OpenTofu、Terragrunt Scale、GitHub Actions、Atlantis 以及各类状态后端配合。
典型场景
多账号多环境管理、单体仓库式 IaC、跨模块依赖编排、企业级基础设施平台。
不足之处
- 生态依赖:完全依附 Terraform/OpenTofu 的版本节奏
- 抽象成本:新成员要同时理解两层工具与 hcl 语法扩展
- 批量风险:run-all 部分失败时状态容易不一致,需要人工介入
- 文档门槛:官方资料偏实践型,入门路径不够系统
适用场景
- 多环境多账号 IaC(★★★★★):目录结构与继承机制发挥最大价值
- 模块数量膨胀的仓库(★★★★★):显著减少重复代码
- 单模块小项目(★★☆☆☆):直接用 Terraform 更简单
- 需要强依赖编排(★★★★☆):自动推导顺序省去手工编排
价格参考
| 项目 | 价格 | 备注 |
|---|---|---|
| Terragrunt 本体 | $0 | Apache 2.0 开源,可商用 |
| Gruntwork 订阅 | 需联系销售 | 含 IaC 库、参考架构与支持 |
| 自建 CI 成本 | 按平台计费 | 取决于并发与运行时长 |
常见问题
Terragrunt 会替代 Terraform 吗?
不会。它调用 Terraform 或 OpenTofu 执行实际的 plan 与 apply,本身只负责编排与配置生成。
可以只用 Terragrunt 不写后端配置吗?
可以。remote_state 块能自动生成 backend 配置,避免每个模块手写一遍。
与 Terraform Workspaces 相比如何?
Workspaces 适合少量同构环境;Terragrunt 更适合环境差异大、模块数量多的场景。
支持 OpenTofu 吗?
支持。Terragrunt 已适配 OpenTofu,可作为其执行引擎。
代码示例
# 根目录 terragrunt.hcl:集中生成远程状态
remote_state {
backend = "s3"
generate = {
path = "backend.tf"
if_exists = "overwrite"
}
config = {
bucket = "my-tf-state"
key = "${path_relative_to_include()}/terraform.tfstate"
region = "us-east-1"
}
}
# prod/app/terragrunt.hcl:继承根配置并声明依赖
include "root" {
path = find_in_parent_folders()
}
terraform {
source = "../../../modules/app"
}
dependency "network" {
config_path = "../network"
}
inputs = {
vpc_id = dependency.network.outputs.vpc_id
}
# 批量执行整个目录下 20+ 个模块
terragrunt run-all plan
terragrunt run-all apply
社区与资源
- 官方网站:https://terragrunt.gruntwork.io/
- 源码仓库:https://github.com/gruntwork-io/terragrunt
- 官方文档:https://terragrunt.gruntwork.io/docs/
前往 Terragrunt 官网 →
https://terragrunt.gruntwork.io/
访问官网 ↗
推荐文章
- 01 GitLab CI/CD 最佳实践:从入门到生产级流水线 07-18
- 02 Prometheus 监控系统搭建:从指标采集到告警通知 07-18
- 03 Ansible 自动化运维实战:从配置管理到应用部署 07-18
- 04 Docker 入门教程:从安装到容器化部署 Web 应用 07-18
- 05 API 集成入门:REST vs GraphQL 对比与选型指南 07-18
- 06 GitHub Actions CI/CD 配置教程:自动化构建、测试与部署 07-18
- 07 Docker Compose 多容器部署:构建完整的应用编排方案 07-18
- 08 Kubernetes 入门部署指南:从零搭建 K8s 集群 07-18
- 09 VS Code 插件推荐 2026:提升开发效率的必备扩展 07-18
- 10 前端开发工具链 2026:Vite / Next.js / Tailwind CSS 生态综述 07-18