企业官网建设流程全解析

Terragrunt Atlantis Config实战案例：多账户VPC与Route53依赖关系自动生成

【免费下载链接】terragrunt-atlantis-configGenerate Atlantis config for Terragrunt projects.项目地址: https://gitcode.com/gh_mirrors/te/terragrunt-atlantis-config

在现代云基础设施管理中，多账户架构下的资源依赖关系管理往往是运维团队面临的一大挑战。Terragrunt Atlantis Config作为一款专为Terragrunt项目设计的配置生成工具，能够自动解析复杂的基础设施依赖关系，大幅提升团队协作效率。本文将通过一个真实的多账户VPC与Route53集成案例，展示如何利用该工具实现依赖关系的自动生成与管理。

多账户架构下的基础设施依赖痛点

在企业级云环境中，通常会采用多账户隔离策略（如网络账户、生产账户、非生产账户等）。以典型的网络拓扑为例：

• 网络账户：管理跨账户共享资源（如Transit Gateway）
• 生产账户：包含多个区域的VPC和Route53资源
• 层级依赖：VPC依赖Transit Gateway，Route53记录依赖VPC的DNS配置

传统手动管理方式需要运维人员：

1. 手动维护数百个模块间的依赖关系
2. 在Atlantis配置中逐个定义depends_on规则
3. 面对账户结构调整时进行繁琐的配置更新

这些工作不仅耗时易错，还会严重影响基础设施部署效率。

实战案例：自动解析多账户依赖关系

项目结构概览

本案例基于test_examples/multi_accounts_vpc_route53_tgw目录结构构建，该架构包含：

multi_accounts_vpc_route53_tgw/ ├── network-account/ # 网络账户 │ └── eu-west-1/ │ └── network/transit-gateway/ # 跨账户共享的Transit Gateway ├── prod/ # 生产账户 │ └── eu-west-1/ │ ├── _global/route53/test-zone/ # Route53 DNS区域 │ └── env-a/network/vpc/ # 应用环境VPC └── terragrunt.hcl # 根配置文件

根配置文件terragrunt.hcl通过以下关键配置实现跨账户变量共享：

locals { # 自动加载环境级变量 environment_vars = read_terragrunt_config(find_in_parent_folders("env.hcl")) } inputs = merge( local.environment_vars.locals, # 合并环境变量到所有子模块 )

依赖关系自动生成原理

Terragrunt Atlantis Config通过分析以下信息自动构建依赖关系图：

1. Terragrunt依赖块：识别dependency和dependencies配置
2. 模块层级结构：基于文件系统目录关系推断依赖方向
3. 变量引用关系：分析跨模块的变量引用（如VPC ID引用）

在本案例中，工具自动识别出以下关键依赖链：

• prod/eu-west-1/env-a/network/vpc→ 依赖 →network-account/eu-west-1/network/transit-gateway
• prod/eu-west-1/_global/route53/test-zone→ 依赖 →prod/eu-west-1/env-a/network/vpc

生成的Atlantis配置示例

工具生成的配置文件（如cmd/golden/multi_accounts_vpc_route53_tgw.yaml）包含以下核心内容：

projects: - dir: multi_accounts_vpc_route53_tgw/network-account/eu-west-1/network/transit-gateway workflow: terragrunt autoplan: enabled: true when_modified: ["*.hcl", "*.tf"] - dir: multi_accounts_vpc_route53_tgw/prod/eu-west-1/env-a/network/vpc workflow: terragrunt autoplan: enabled: true when_modified: ["*.hcl", "*.tf"] depends_on: - dir: multi_accounts_vpc_route53_tgw/network-account/eu-west-1/network/transit-gateway - dir: multi_accounts_vpc_route53_tgw/prod/eu-west-1/_global/route53/test-zone workflow: terragrunt autoplan: enabled: true when_modified: ["*.hcl", "*.tf"] depends_on: - dir: multi_accounts_vpc_route53_tgw/prod/eu-west-1/env-a/network/vpc

这种自动生成的配置确保了基础设施部署的正确顺序，避免了因依赖关系错误导致的部署失败。

快速上手：三步实现依赖关系自动管理

1. 安装Terragrunt Atlantis Config

git clone https://gitcode.com/gh_mirrors/te/terragrunt-atlantis-config cd terragrunt-atlantis-config make build

2. 配置项目目录结构

确保你的Terragrunt项目遵循标准的多账户结构：

• 按账户划分顶级目录（如network-account/、prod/）
• 在每个环境目录中放置env.hcl定义环境变量
• 使用Terragrunt的dependency块声明显式依赖

3. 生成Atlantis配置

在项目根目录执行：

terragrunt-atlantis-config generate --output atlantis.yaml

工具将自动扫描所有Terragrunt模块，分析依赖关系，并生成完整的Atlantis配置文件。

高级应用：自定义依赖关系规则

对于复杂场景，你可以通过以下方式自定义依赖规则：

1. 使用环境变量控制依赖解析

在env.hcl中定义依赖解析规则：

locals { atlantis_depends_on = [ "//network-account/eu-west-1/network/*", ] }

2. 通过命令行参数过滤模块

terragrunt-atlantis-config generate \ --filter "prod/eu-west-1/*" \ --output atlantis-prod.yaml

3. 合并多个配置文件

terragrunt-atlantis-config generate \ --include atlantis-base.yaml \ --output atlantis.yaml

总结：提升多账户基础设施管理效率

通过Terragrunt Atlantis Config，团队可以获得以下收益：

• 减少80%的手动配置工作：自动解析依赖关系，无需手动编写depends_on规则
• 消除依赖配置错误：基于代码分析生成准确的依赖关系图
• 加速基础设施部署：确保资源按正确顺序部署，减少失败重试
• 简化团队协作：统一的依赖管理策略，降低新成员上手难度

无论是管理包含数十个账户的企业级基础设施，还是简单的多环境部署，Terragrunt Atlantis Config都能成为你基础设施即代码（IaC）工具箱中的重要工具。立即尝试，体验自动化依赖管理带来的效率提升！

【免费下载链接】terragrunt-atlantis-configGenerate Atlantis config for Terragrunt projects.项目地址: https://gitcode.com/gh_mirrors/te/terragrunt-atlantis-config