devopsinfra/docker-terragrunt

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

支持amd64和arm64架构！

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

源码与Docker镜像

源码托管于 https://github.com/devops-infra/docker-terragrunt%E3%80%82

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%E7%9A%84%E4%B8%A4%E4%B8%AA%E9%95%9C%E5%83%8F%E6%9E%84%E5%BB%BA%EF%BC%9Ahttps://github.com/cytopia/docker-terragrunt%E5%92%8Chttps://github.com/cytopia/docker-terragrunt-fmt%E3%80%82%E5%8E%9F%E5%A7%8BREADME%E6%96%87%E4%BB%B6%E5%8C%85%E5%90%AB%E5%9C%A8%E6%9C%AC%E4%BB%93%E5%BA%93%E4%B8%AD%EF%BC%9Ahttps://github.com/devops-infra/docker-terragrunt/blob/master/README.docker-terragrunt.md%E5%92%8Chttps://github.com/devops-infra/docker-terragrunt/blob/master/README.docker-terragrunt-fmt.md%E3%80%82%E6%9C%AC%E9%A1%B9%E7%9B%AE%E8%BE%83%E5%8E%9F%E5%A7%8B%E9%A1%B9%E7%9B%AE%E6%9C%89%E8%BE%83%E5%A4%A7%E6%89%A9%E5%B1%95%EF%BC%8C%E6%97%A8%E5%9C%A8%E6%88%90%E4%B8%BA%E4%BA%91%E5%9F%BA%E7%A1%80%E8%AE%BE%E6%96%BD%E5%8D%B3%E4%BB%A3%E7%A0%81%EF%BC%88IaC%EF%BC%89%E7%9A%84%E6%A1%86%E6%9E%B6%E3%80%82

可用镜像源

镜像标签指示其包含的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 \
    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 \
    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 \
    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 \
    devopsinfra/docker-terragrunt:aws-latest make build

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

脚本

二进制文件和Python库

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