clowa/terraform

HashiCorp Terraform 容器镜像文档

镜像概述和主要用途

本镜像为包含HashiCorp官方Terraform二进制文件的Docker镜像，旨在提供便捷、隔离的Terraform运行环境。用户无需在本地系统安装Terraform，可直接通过容器快速使用官方版本的Terraform工具，适用于基础设施即代码（IaC）管理场景。默认情况下，镜像会在https://github.com/hashicorp/terraform%E7%9A%84%E6%9C%80%E6%96%B0%E7%A8%B3%E5%AE%9A%E7%89%88%E6%9C%AC%E5%8F%91%E5%B8%83%E5%B9%B6%E5%8F%AF%E7%94%A8%E5%90%8E%EF%BC%8C%E4%BA%8EUTC%E6%97%B6%E9%97%B4%E5%8D%88%E5%A4%9C12%E7%82%B9%E8%87%AA%E5%8A%A8%E6%9E%84%E5%BB%BA%E3%80%82%E6%9B%B4%E5%A4%9A%E8%AF%A6%E6%83%85%E5%8F%AF%E5%8F%82%E8%80%83%E9%95%9C%E5%83%8F%E7%9A%84https://github.com/clowa/docker-terraform%E3%80%82

核心功能和特性

• 官方二进制集成：内置HashiCorp官方发布的Terraform二进制文件，确保与官方版本完全一致，保障工具的安全性和功能可靠性。
• 自动版本更新：默认配置下，在Terraform最新稳定版本于官方仓库发布并可用后，会自动在UTC时间午夜12点构建镜像，保持镜像中Terraform版本的及时性。
• 轻量级容器化：以容器形式提供Terraform运行环境，便于在各类平台（本地开发环境、服务器、CI/CD流水线）快速部署，同时实现运行环境隔离，避免系统依赖冲突。

使用场景和适用范围

• IaC基础设施管理：适用于通过Terraform定义、部署和管理云基础设施（如AWS、Azure、GCP等）的场景。
• 开发环境快速配置：开发人员无需本地安装Terraform，通过容器即可启动工具，简化环境配置流程。
• CI/CD流水线集成：在持续集成/持续部署流程中作为执行Terraform命令（如init、plan、apply）的标准化环境，确保流水线环境一致性。
• 多版本隔离：需在独立环境中运行不同版本Terraform的场景（需配合版本标签使用），可通过容器实现版本隔离。

使用方法和配置说明

基本使用方式

通过docker run命令运行容器，挂载本地工作目录至容器内以访问Terraform配置文件（.tf文件），并指定工作目录。基本命令格式如下：

bash
docker run --rm -v $(pwd):/workspace -w /workspace [镜像名称]:[标签] [terraform命令] [参数]

• --rm：容器退出后自动删除，避免残留容器实例。
• -v $(pwd):/workspace：将当前本地目录挂载至容器内的/workspace目录，使容器可访问本地Terraform配置文件。
• -w /workspace：设置容器工作目录为/workspace，即命令执行上下文目录。
• [镜像名称]:[标签]：默认镜像名称通常为clowa/terraform（基于GitHub仓库推断），标签可指定版本（如latest为最新稳定版）。
• [terraform命令]：需执行的Terraform命令（如init、plan、apply、destroy等）。
• [参数]：Terraform命令的附加参数（如-var-file=variables.tfvars）。

部署示例

初始化Terraform配置

在包含Terraform配置文件（如main.tf）的本地目录中，执行以下命令初始化工作目录：

bash
docker run --rm -v $(pwd):/workspace -w /workspace clowa/terraform:latest init

生成执行计划

初始化后，生成基础设施部署计划：

bash
docker run --rm -v $(pwd):/workspace -w /workspace clowa/terraform:latest plan

应用执行计划

应用生成的计划以部署基础设施：

bash
docker run --rm -v $(pwd):/workspace -w /workspace clowa/terraform:latest apply

指定特定版本

如需使用特定版本的Terraform，可通过标签指定（需确认镜像是否提供对应版本标签，详情参考https://github.com/clowa/docker-terraform%EF%BC%89%E3%80%82%E4%BE%8B%E5%A6%82%E4%BD%BF%E7%94%A81.6.0%E7%89%88%E6%9C%AC%EF%BC%9A

bash
docker run --rm -v $(pwd):/workspace -w /workspace clowa/terraform:1.6.0 plan

注意事项

• 目录权限：确保本地挂载目录具有适当权限，容器需有读取配置文件和写入状态文件（.tfstate）的权限。
• 凭证传递：如需使用云服务提供商凭证（如AWS_ACCESS_KEY_ID），可通过-e参数传递环境变量，例如：

  bash
  docker run --rm -v $(pwd):/workspace -w /workspace -e AWS_ACCESS_KEY_ID=your_key -e AWS_SECRET_ACCESS_KEY=your_secret clowa/terraform:latest apply
  

• 版本标签：具体可用版本标签请参考镜像的https://github.com/clowa/docker-terraform%E6%96%87%E6%A1%A3%E3%80%82