Minidocks/terraform Docker镜像文档

镜像概述和主要用途

Minidocks/terraform是一个最小化的Terraform Docker镜像，基于开源基础设施即代码（Infrastructure as Code, IaC）工具Terraform构建。它提供一致的命令行界面（CLI）工作流，用于管理数百种云服务，将云服务的API编码为声明式配置文件，实现基础设施的自动化部署、版本控制和生命周期管理。

核心功能和特性

• 最小化设计：镜像体积精简，适合资源受限环境和高效部署场景
• 完整CLI支持：包含Terraform核心命令（init、plan、apply、destroy等），满足标准基础设施管理需求
• 多标签版本：提供多种功能标签，适配不同使用场景：
  • latest/1：基础Terraform版本，包含核心功能
  • terragrunt：集成Terragrunt工具（Terraform封装工具，支持模块化配置和远程状态管理）
  • terraformer-*：集成Terraformer工具，针对不同云平台（Azure、AWS、Google Cloud、Kubernetes），支持从现有基础设施反向生成Terraform配置

使用场景和适用范围

• 云基础设施管理：适用于AWS、Azure、Google Cloud等主流云服务的基础设施声明式配置与自动化部署
• DevOps工作流集成：可嵌入CI/CD管道，实现基础设施变更的自动化验证、测试和部署
• 团队协作与版本控制：通过配置文件标准化基础设施定义，支持Git等版本控制系统进行协作管理
• 工具链扩展：结合Terragrunt实现复杂项目的模块化管理，或通过Terraformer实现现有基础设施的代码化迁移

详细使用方法和配置说明

拉取镜像

根据需求拉取对应标签的镜像：

bash
# 拉取基础版本
docker pull minidocks/terraform:latest

# 拉取集成Terragrunt的版本
docker pull minidocks/terraform:terragrunt

# 拉取AWS专用Terraformer版本
docker pull minidocks/terraform:terraformer-aws

基本使用示例

运行Terraform命令时，需将本地配置文件目录挂载至容器，并根据云服务要求配置认证信息（如环境变量、配置文件挂载等）。

初始化Terraform项目

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

执行基础设施规划

bash
# 示例：AWS环境（需配置访问凭证）
docker run --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  -e AWS_ACCESS_KEY_ID="your_access_key" \
  -e AWS_SECRET_ACCESS_KEY="your_secret_key" \
  minidocks/terraform:latest \
  terraform plan

应用基础设施变更

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

Terragrunt使用示例

针对terragrunt标签，可直接运行Terragrunt命令：

bash
# 初始化Terragrunt项目
docker run --rm -v $(pwd):/workspace -w /workspace minidocks/terraform:terragrunt terragrunt init

# 执行跨模块规划
docker run --rm -v $(pwd):/workspace -w /workspace minidocks/terraform:terragrunt terragrunt run-all plan

Terraformer使用示例

针对特定云平台的Terraformer版本，从现有基础设施生成配置：

bash
# 示例：从AWS VPC和子网生成Terraform配置
docker run --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  -e AWS_ACCESS_KEY_ID="your_access_key" \
  -e AWS_SECRET_ACCESS_KEY="your_secret_key" \
  minidocks/terraform:terraformer-aws \
  terraformer import aws --resources=vpc,subnet --region=us-west-2

标签信息