Terraform Docker镜像文档

概述

本镜像由Oowy团队维护，基于轻量级Alpine Linux构建，封装了Terraform CLI工具。Terraform是一款基础设施即代码(IaC)工具，可安全高效地构建、变更和版本化管理基础设施，包括计算实例、存储、网络等底层组件及DNS条目、SaaS功能等高层组件，支持现有服务提供商和自定义内部解决方案。

核心功能与特性

• 基础设施即代码(IaC): 通过代码定义和管理基础设施，支持版本控制与协作
• 安全高效: 安全处理基础设施变更，减少人为错误，支持版本化管理
• 轻量级基础: 基于Alpine Linux，镜像体积小，资源占用低
• 多版本支持: 提供多个Terraform版本标签，适配不同需求场景
• 跨架构兼容: 支持amd64和arm64v8架构

支持的标签

基于Alpine Linux 3.20

• latest
• 1.11.4-alpine3.20 1.11.3-alpine3.20 1.11.2-alpine3.20 1.11.1-alpine3.20 1.11.0-alpine3.20

基于Alpine Linux 3.19

• 1.10.5-alpine3.19 1.10.4-alpine3.19 1.10.3-alpine3.19 1.10.2-alpine3.19 1.10.1-alpine3.19 1.10.0-alpine3.19
• 1.9.8-alpine3.19 1.9.7-alpine3.19 1.9.6-alpine3.19 1.9.5-alpine3.19 1.9.4-alpine3.19 1.9.3-alpine3.19 1.9.2-alpine3.19 1.9.1-alpine3.19 1.9.0-alpine3.19
• 1.8.5-alpine3.19 1.8.4-alpine3.19 1.8.3-alpine3.19 1.8.2-alpine3.19 1.8.1-alpine3.19 1.8.0-alpine3.19
• 1.7.5-alpine3.19 1.7.4-alpine3.19 1.7.3-alpine3.19 1.7.2-alpine3.19 1.7.1-alpine3.19 1.7.0-alpine3.19 1.6.6-alpine3.19 1.6.5-alpine3.19

基于Alpine Linux 3.18

• 1.7.5-alpine3.18 1.7.4-alpine3.18 1.7.3-alpine3.18 1.7.2-alpine3.18 1.7.1-alpine3.18 1.7.0-alpine3.18
• 1.6.6-alpine3.18 1.6.5-alpine3.18 1.6.4-alpine3.18 1.6.3-alpine3.18 1.6.2-alpine3.18 1.6.1-alpine3.18 1.6.0-alpine3.18
• 1.5.7-alpine3.18
• 1.4.7-alpine3.18
• 1.3.10-alpine3.18
• 1.2.9-alpine3.18
• 1.1.9-alpine3.18

基于Alpine Linux 3.17

• 1.6.5-alpine3.17 1.6.4-alpine3.17 1.6.3-alpine3.17 1.6.2-alpine3.17 1.6.1-alpine3.17 1.6.0-alpine3.17
• 1.5.7-alpine3.17
• 1.4.7-alpine3.17
• 1.3.10-alpine3.17
• 1.2.9-alpine3.17
• 1.1.9-alpine3.17

支持的架构

• amd64
• arm64v8

使用场景

• 容器化隔离的Terraform开发环境
• CI/CD流程中集成基础设施部署步骤
• 需要统一Terraform版本的团队协作环境
• 构建包含预设配置的自定义Terraform镜像

使用方法

基本命令

通过docker run执行Terraform子命令，例如生成执行计划：

bash
docker run -i -t oowy/terraform:latest plan

生产建议: 使用特定版本标签（如1.11.4-alpine3.20）替代latest，确保环境一致性。

挂载配置与凭证

Terraform需访问配置文件和云服务商凭证，典型配置方式：

1. 挂载本地配置目录：

bash
docker run -v $(pwd):/terraform -w /terraform oowy/terraform:1.11.4-alpine3.20 init

2. 传递环境变量：

bash
docker run -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE -e AWS_SECRET_ACCESS_KEY=secret \
  -v $(pwd):/terraform -w /terraform oowy/terraform:1.11.4-alpine3.20 apply

3. 指定工作目录：

bash
docker run -v $(pwd)/tf-config:/workspace -w /workspace oowy/terraform:1.11.4-alpine3.20 validate

构建自定义镜像

以本镜像为基础，预设CLI配置：

dockerfile
FROM oowy/terraform:1.11.4-alpine3.20

# 添加自定义Terraform配置
RUN mkdir -p /root/.terraform.d
COPY terraform.rc /root/.terraform.d/terraform.rc

社区支持

• 问题反馈: 有关Terraform二进制文件的问题，请在主Terraform仓库提交issue
• 帮助渠道:
  • Docker社区Slack
  • Server Fault
  • Unix & Linux
  • Stack Overflow