Terragrunt

Definition

Terragrunt 是由 Gruntwork 开发的Terraform 轻量封装工具，核心目标是贯彻 DRY（Don't Repeat Yourself）原则，简化多环境、多账户 Terraform 配置的管理。

Core Value

Terragrunt 对 Terraform 的核心改进在于减少重复配置：

问题	Terraform 方案	Terragrunt 方案
provider 块重复	每个环境独立声明	`terragrunt.hcl` 统一管理
remote_state 块重复	多处硬编码	模板化复用
模块引用方式	固定分支引用	版本锁定引用
多环境同步	手动复制配置	`include` 块继承

来源: ctp-topic-48-terraform-vs-terragrunt

Compatibility

Terragrunt 完全兼容 Terraform 的所有命令和 HCL 语法：

terragrunt plan → 底层调用 terraform plan
terragrunt apply → 底层调用 terraform apply
所有 Terraform HCL 块和属性完全兼容

这意味着 Terragrunt 不是 Terraform 的替代品，而是增强层。

来源: ctp-topic-48-terraform-vs-terragrunt

Key Features

DRY Remote State

通过 remote_state 块集中管理状态文件位置：

remote_state {
  backend = "s3"
  config = {
    bucket = "my-terraform-state"
    key    = "${path_relative_to_include()}/terraform.tfstate"
    region = "eu-west-1"
    encrypt = true
  }
}

Provider Management

跨环境统一 provider 配置，避免在每个模块中重复声明。

Include & Inheritance

通过 include 块实现配置的继承与覆盖：

include {
  path = find_in_parent_folders("root.hcl")
}

Use Case: Micro Focus Labs Landing Zone

Micro Focus Labs Landing Zone 使用 Terragrunt 管理多账户配置，所有资源通过 Terraform/Terragrunt 管理，Jenkins 流水线扫描 GitHub 仓库变更触发 plan/apply。

来源: ctp-topic-3-deploy-and-maintain-infrastructure, ctp-topic-25-labs-landing-zone-overview-itom-teams

Ecosystem Position

Terraform Ecosystem
├── Terraform (HashiCorp) — 核心 IaC 引擎
├── Terragrunt (Gruntwork) — DRY 封装层 ←
├── Terraform Enterprise (HashiCorp) — 企业 CI 平台
└── Gruntwork Library (Gruntwork) — 预建模块库

Terraform — Terragrunt 包装的核心引擎
HashiCorp — Terraform 创立公司
Gruntwork — Terragrunt 开发公司

Infrastructure-as-Code — Terragrunt 的应用领域
DRY Principle — Terragrunt 的设计哲学

ctp-topic-48-terraform-vs-terragrunt
ctp-topic-3-deploy-and-maintain-infrastructure
ctp-topic-15-working-with-renovatebot
learning-sessions-cloud-transformation-programme-deploying-rds-via-terraform

2.9 KiB Raw Blame History Unescape Escape