asuuto/dco-terragrunt

Terragrunt Docker镜像文档

镜像概述

本镜像包含Terragrunt工具，旨在提供一个便捷的容器化环境，用于管理和执行Terraform配置。Terragrunt是Terraform的封装工具，通过自动化远程状态配置、模块下载和重复配置管理，简化多模块基础设施即代码（IaC）的部署流程。

核心功能与特性

• Terragrunt集成：内置最新稳定版Terragrunt，可直接执行terragrunt命令
• Terraform兼容：与Terraform工具无缝集成，支持执行init、plan、apply等标准命令
• 远程状态管理：自动配置和维护Terraform远程状态存储（如S3、GCS等）
• 模块管理：自动下载和缓存Terraform模块，简化依赖管理
• DRY配置支持：通过terragrunt.hcl文件集中管理重复配置，减少代码冗余

使用场景

• CI/CD流水线：在持续集成/部署流程中嵌入，标准化基础设施部署环境
• 本地开发：为开发人员提供一致的Terragrunt运行环境，避免本地工具版本冲突
• 多模块基础设施：管理包含多个相互依赖的Terraform模块的复杂基础设施
• 远程团队协作：确保团队成员使用统一版本的Terragrunt工具链

使用方法与配置说明

基本使用

通过docker run命令启动容器并执行Terragrunt命令：

bash
docker run --rm -v $(pwd):/workspace -w /workspace terragrunt:latest terragrunt <command>

参数说明：

• --rm：容器退出后自动删除
• -v $(pwd):/workspace：将当前目录挂载到容器内的/workspace工作目录
• -w /workspace：设置工作目录为/workspace
• terragrunt:latest：镜像名称及标签（可指定具体版本，如terragrunt:0.53.0）
• <command>：Terragrunt命令（如init、plan、apply、destroy等）

示例：初始化Terraform配置

bash
docker run --rm -v $(pwd):/workspace -w /workspace terragrunt:latest terragrunt init

示例：执行部署计划

bash
docker run --rm -v $(pwd):/workspace -w /workspace terragrunt:latest terragrunt plan

环境变量配置

如需传递环境变量（如云服务提供商凭证），可使用-e参数：

bash
docker run --rm \
  -v $(pwd):/workspace -w /workspace \
  -e AWS_ACCESS_KEY_ID=your_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret_key \
  terragrunt:latest terragrunt apply

持久化缓存

如需保留Terraform模块和插件缓存，可挂载缓存目录：

bash
docker run --rm \
  -v $(pwd):/workspace \
  -v ~/.terragrunt-cache:/root/.terragrunt-cache \
  -w /workspace \
  terragrunt:latest terragrunt init

注意事项

• 版本兼容性：请根据需求选择合适的镜像标签（版本），确保与Terraform版本兼容
• 文件权限：挂载本地目录时可能需要调整文件权限，避免容器内权限不足
• 远程状态配置：需在terragrunt.hcl中正确配置远程状态存储（如S3、Azure Blob Storage等）以充分利用Terragrunt功能