arichtman/terragrunt

Terragrunt工具集成镜像

镜像概述

本镜像集成了Terraform、Terragrunt、OpenTofu等多种基础设施即代码(IaC)工具，旨在简化和自动化Terraform部署流程。当Terraform等工具发布新版本时，会自动触发镜像构建，确保用户能够使用最新工具版本。支持多架构部署，适用于CI/CD流程及自动化构建部署场景。

核心功能与特性

工具集成

• Terraform：版本与镜像标签对应
• Terragrunt：构建时的最新版本
• Boilerplate：构建时的最新版本
• Terraform-docs：构建时的最新版本
• OpenTofu：构建时的最新版本

版本管理

• 支持多种标签格式：
  • alpine/terragrunt:latest：最新版本
  • alpine/terragrunt:tf-<version>：指定Terraform版本（如tf-1.8.4）
  • alpine/terragrunt:tg-<version>：指定Terragrunt版本（如tg-0.58.14）
  • alpine/terragrunt:otf-<version>：指定OpenTofu版本（如otf-1.7.1）
• 重要：生产环境中禁止使用latest标签，建议使用具体版本标签

架构支持

• linux/amd64
• linux/arm64

使用场景

• 持续集成/持续部署(CI/CD)流程
• 自动化构建与部署系统组件
• 本地IaC开发与测试环境

使用方法

基本要求

1. 必须将本地工作目录挂载到容器的/apps目录
2. 需挂载AWS凭证目录（通常为~/.aws）和SSH配置目录（通常为~/.ssh）

Docker运行示例

bash
# 基础运行命令（以tg-0.58.14版本为例）
docker run -ti --rm \
  -v $HOME/.aws:/root/.aws \
  -v $HOME/.ssh:/root/.ssh \
  -v $(pwd):/apps \
  alpine/terragrunt:tg-0.58.14 bash

常用命令

Terraform操作

bash
# 初始化配置
terraform init
# 格式化代码
terraform fmt
# 验证配置
terraform validate
# 生成执行计划
terraform plan
# 应用配置
terraform apply

OpenTofu操作

bash
# 初始化配置
tofu init
# 格式化代码
tofu fmt
# 验证配置
tofu validate
# 生成执行计划
tofu plan
# 应用配置
tofu apply

Terragrunt操作

bash
# 格式化HCL文件
terragrunt hclfmt
# 批量执行计划（所有模块）
terragrunt run-all plan
# 批量应用配置（所有模块）
terragrunt run-all apply

构建流程

1. 仓库主分支配置每周CI定时任务触发构建
2. 通过Terraform Github REST API检查工具新版本
3. 对比Docker Hub现有标签，若版本不匹配则构建新镜像
4. 镜像标签以最新Terraform版本命名并推送到Docker Hub
5. 始终安装最新版本的Terragrunt

相关链接

• 代码仓库：https://github.com/arichtman/terragrunt
• 构建日志：[***]
• 镜像标签：https://hub.docker.com/r/arichtman/terragrunt/tags/

版本兼容性

Terraform与Terragrunt版本兼容性请参考官方文档：
[***]