PROVIDER - Terraform 的 DRY 编排包装器

Terragrunt

Terragrunt 是 Terraform 与 OpenTofu 的 DRY 包装器,用 1 套目录层级收敛后端与 provider 配置,自动处理依赖顺序并支持 run-all 批量执行 20+ 模块;代价是抽象层带来的学习成本与上游版本兼容跟进。

开发工具 美国 2026.11.19
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/
访问官网 ↗