Terragrunt Docker 镜像文档

镜像概述和主要用途

本镜像为基于 Alpine Linux 的轻量级多阶段构建 Docker 镜像，包含 Terragrunt 工具及其兼容版本的 Terraform。旨在提供可重现的运行环境，特别适用于 CI/CD 流程中基础设施即代码（IaC）的自动化部署、验证和管理，也可用于本地开发环境以确保工具版本一致性。

核心功能和特性

• 轻量级基础：基于 Alpine Linux，镜像体积小，资源占用低
• 多阶段构建：通过多阶段构建优化镜像大小，仅保留运行时必要文件
• 版本兼容：内置与 Terragrunt 兼容的特定版本 Terraform，避免版本冲突
• 多架构支持：提供 amd64、i386、arm64 架构支持，适配不同硬件环境
• CI 友好：设计用于自动化流程，支持非 root 用户运行，避免权限问题
• 滚动更新：通过 nightly 构建确保镜像包含最新的工具版本更新

使用场景和适用范围

• CI/CD 流程集成：在 Jenkins、GitLab CI、GitHub Actions 等平台中执行 Terragrunt 命令（如 init、plan、apply），实现基础设施自动化部署
• 本地开发环境：无需在本地安装 Terragrunt 和 Terraform，通过 Docker 快速启动一致的工具环境，避免版本差异导致的问题
• 多版本并行：通过指定不同 Docker 标签，在同一环境中切换不同版本的 Terragrunt 和 Terraform，适配多项目需求
• 基础设施验证：在代码提交前通过镜像执行 terragrunt validate、terragrunt plan 等命令，提前发现配置错误

可用镜像版本

以下为滚动更新的 Docker 镜像标签，对应不同版本的 Terraform 和 Terragrunt：

Docker 挂载点

容器内的工作目录为 /data/，需将本地 Terragrunt 项目目录挂载至此路径，以确保工具能访问项目文件。

使用方法和配置说明

基本命令格式

docker run --rm -v $(pwd):/data cytopia/terragrunt:<TAG> terragrunt <ARGS>
docker run --rm -v $(pwd):/data cytopia/terragrunt:<TAG> terraform <ARGS>

• --rm：容器退出后自动删除
• -v $(pwd):/data：将当前目录挂载到容器内 /data 目录
• <TAG>：指定 Docker 镜像标签（如 latest、1.3-0.40）
• <ARGS>：Terragrunt 或 Terraform 命令参数（如 init、plan、apply）

示例

1. 初始化 Terragrunt 项目

docker run --rm -v $(pwd):/data cytopia/terragrunt terragrunt init

2. 执行 Terragrunt 计划

docker run --rm -v $(pwd):/data cytopia/terragrunt:1.3-0.40 terragrunt plan

3. 应用 Terragrunt 配置

docker run --rm -v $(pwd):/data cytopia/terragrunt terragrunt apply

4. 以非 root 用户运行（避免权限问题）

docker run --rm -v $(pwd):/data -e RUN_NON_ROOT=1 -e UID=$(id -u) -e GID=$(id -g) cytopia/terragrunt terragrunt validate

环境变量

Docker Compose 配置示例

创建 docker-compose.yml 文件：

version: '3'
services:
  terragrunt:
    image: cytopia/terragrunt:latest
    volumes:
      - ./:/data
    environment:
      - RUN_NON_ROOT=1
      - UID=${UID}
      - GID=${GID}
    command: terragrunt plan

运行：

UID=$(id -u) GID=$(id -g) docker-compose up

相关 CI 工具镜像

以下为适用于 CI/CD 流程的相关 Docker 镜像，可用于代码 lint、格式检查等自动化场景：

许可证

MIT 许可证

Copyright (c) 2019 cytopia