devopsinfra/docker-terragrunt

容器化IaC框架：Terraform、OpenTofu与Terragrunt

支持amd64和arm64架构！

由于镜像体积较大及Docker Hub限制，目前正在优化减小体积。请使用最新版本镜像以获取活跃版本支持，超过3个月的旧镜像将被删除。

源码与Docker镜像

源码托管于 https://github.com/devops-infra/docker-terragrunt。

Docker Hub镜像地址：https://hub.docker.com/repository/docker/devopsinfra/docker-terragrunt

GitHub Packages镜像地址：https://github.com/devops-infra/docker-terragrunt/pkgs/container/docker-terragrunt

概述

该Docker镜像包含Terraform、OpenTofu或Terragrunt，同时集成Terragrunt、Go、Python、Make、Docker、Git及所有必要组件，可轻松管理CI/CD环境中的云基础设施，作为runner镜像使用。

内置亚马逊AWS、微软Azure、谷歌云平台（GCP） 的云服务CLI和SDK。

最适用于CI/CD自动化中的runner镜像，以及本地一致的运行环境。

请注意，这些镜像的重点是维护Terraform、OpenTofu和Terragrunt的当前版本可用性，而非CLI或其他依赖项。因此，当Terraform、OpenTofu或Terragrunt发布新版本时，镜像会同步更新。此外，镜像的版本标签包含上述软件版本以突出核心特性。

Dockerfile基于https://github.com/cytopia的两个镜像构建：https://github.com/cytopia/docker-terragrunt和https://github.com/cytopia/docker-terragrunt-fmt。原始README文件包含在本仓库中：https://github.com/devops-infra/docker-terragrunt/blob/master/README.docker-terragrunt.md和https://github.com/devops-infra/docker-terragrunt/blob/master/README.docker-terragrunt-fmt.md。本项目较原始项目有较大扩展，旨在成为云基础设施即代码（IaC）的框架。

可用镜像源

镜像标签指示其包含的Terraform和Terragrunt版本，以及是否捆绑公共云提供商CLI（见下方表格）。

可用镜像类型

镜像标签还指示其包含的云API/SDK。

使用方法

• 处理本地文件时 - 将工作目录挂载到/data，例如--volume $(pwd):/data。
• 处理云提供商时 - 通过附加文件或环境变量传递凭据，例如--env AWS_SESSION_TOKEN=${AWS_SESSION_TOKEN}或--volume ~/.aws/credentials:/root/.aws/credentials。
• 运行其他Docker镜像时 - 共享Docker套接字，例如--privileged --volume /var/run/docker.sock:/var/run/docker.sock。
• 配置git时 - 挂载所需的.gitconfig和/或SSH密钥（如需要），例如--volume ~/.gitconfig:/root/.gitconfig --volume ~/.ssh/id_rsa_github:/root/.ssh/id_rsa。

推荐挂载的.gitconfig示例

• 使用带个人访问令牌（PAT）的https：

[url "https://{GITHUB_TOKEN}@github.com/"]
	insteadOf = https://github.com/
[url "https://{GITHUB_TOKEN}@github.com/"]
	insteadOf = git+ssh://github.com/
[url "https://{GITHUB_TOKEN}@github.com/"]
	insteadOf = git@github.com:

• 使用https代替git/ssh：

[url "https://github.com/"]
	insteadOf = git+ssh://github.com/
[url "https://github.com/"]
	insteadOf = git@github.com:

• 使用ssh代替https：

[url "ssh://git@github.com/"]
  insteadOf = https://github.com/
[url "ssh://git@github.com/"]
	insteadOf = git@github.com:

使用示例

• 格式化当前目录（含子目录）中的所有HCL文件：

bash
docker run --rm \
    --user $(id -u):$(id -g) \
    --volume $(pwd):/data \
    docker.xuanyuan.run/devopsinfra/docker-terragrunt:latest format-hcl

• 在AWS中规划当前目录的Terraform部署：

bash
docker run --rm \
    --tty --interactive \
    --env AWS_DEFAULT_REGION=${AWS_DEFAULT_REGION} \
    --env AWS_ACCESS_KEY_ID=${AWS_ACCESS_KEY_ID} \
    --env AWS_SECRET_ACCESS_KEY=${AWS_SECRET_ACCESS_KEY} \
    --env AWS_SESSION_TOKEN=${AWS_SESSION_TOKEN} \
    --user $(id -u):$(id -g) \
    --volume $(pwd):/data \
    docker.xuanyuan.run/devopsinfra/docker-terragrunt:aws-latest terraform plan

• 在子目录中应用Terragrunt部署，使用带PAT的~/.gitconfig文件连接GitHub：

bash
docker run --rm \
    --tty --interactive \
    --user $(id -u):$(id -g) \
    --volume $(pwd):/data \
    --volume ~/.gitconfig:/root/.gitconfig \
    docker.xuanyuan.run/devopsinfra/docker-terragrunt:aws-latest terragrunt apply --terragrunt-working-dir some/module

• 运行Makefile目标作为编排脚本：

bash
docker run --rm \
    --tty --interactive \
    --user $(id -u):$(id -g) \
    --volume $(pwd):/data \
    docker.xuanyuan.run/devopsinfra/docker-terragrunt:aws-latest make build

所有镜像中包含的附加软件

脚本

二进制文件和Python库

部分软件因所选镜像类型而异，标记为*