Terraform 是一款基础设施即代码(IaC)工具,允许您安全高效地构建、更改和版本化基础设施。这包括底层组件(如计算实例、存储和网络)以及高层组件(如DNS条目、SaaS功能等)。Terraform既能管理现有的服务提供商,也能管理自定义的内部解决方案。
在Docker容器中运行Terraform比直接运行Terraform CLI可执行文件需要更多配置。除非需要容器隔离,否则建议使用非容器化的Terraform CLI包。
Terraform团队为每个Terraform CLI的官方版本在本仓库发布Docker镜像。每个版本化镜像均包含与其版本号相同的Terraform CLI版本。
这些镜像封装了terraform可执行文件,允许您通过将子命令名称和参数作为docker run的一部分传入来运行Terraform子命令。例如,以下命令使用'latest'标签,通过最新版本的Terraform生成执行计划:
shelldocker run -i -t hashicorp/terraform:latest plan
请注意,对于生产环境,建议指定具体版本而非使用latest。
您可能需要进一步配置容器,以便Terraform能够访问您的配置文件和提供商凭证。这可能包括将配置挂载到容器中、设置工作目录以引用您的配置,以及传递环境变量和凭证文件(针对您要使用的提供商)。docker run文档列出了可用于自定义容器环境的选项。
您也可以将这些镜像用作自己镜像的基础。例如,如果您希望将CLI配置设置预设为镜像的一部分,这会很有帮助。
1. 挂载本地配置文件并运行计划
要让Terraform访问本地配置文件,需将配置目录挂载到容器中。例如,将当前目录的配置文件挂载到容器的/tf目录,并设置工作目录为/tf:
shelldocker run -i -t -v $(pwd):/tf -w /tf hashicorp/terraform:1.6.0 plan
2. 传递环境变量(如提供商凭证)
对于需要环境变量的提供商(如AWS的AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY),可使用-e选项传递:
shelldocker run -i -t -v $(pwd):/tf -w /tf -e AWS_ACCESS_KEY_ID=your_key -e AWS_SECRET_ACCESS_KEY=your_secret hashicorp/terraform:1.6.0 apply
3. 使用特定版本并指定工作目录
生产环境中应指定具体版本,例如使用1.6.0版本,并设置工作目录到配置所在路径:
shelldocker run -i -t -v /path/to/terraform/config:/app -w /app hashicorp/terraform:1.6.0 apply
有关Terraform Docker镜像的问题,请在https://github.com/hashicorp/terraform%E4%B8%AD%E6%8F%90%E4%BA%A4issue%E3%80%82
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。



探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
无需登录使用专属域名
Kubernetes 集群配置 Containerd
K3s 轻量级 Kubernetes 镜像加速
VS Code Dev Containers 配置
Podman 容器引擎配置
HPC 科学计算容器配置
ghcr、Quay、nvcr 等镜像仓库
Harbor Proxy Repository 对接专属域名
Portainer Registries 加速拉取
Nexus3 Docker Proxy 内网缓存
需要其他帮助?请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
docker search 限制
站内搜不到镜像
离线 save/load
插件要用 plugin install
WSL 拉取慢
安全与 digest
新手拉取配置
镜像合规机制
manifest unknown
no matching manifest(架构)
invalid tar header(解压)
TLS 证书失败
DNS 超时
域名连通性排查
410 Gone 排查
402 与流量用尽
401 认证失败
429 限流
D-Bus 凭证提示
413 与超大单层
来自真实用户的反馈,见证轩辕镜像的优质服务