flipstone/terraform-aws

Terraform与AWS CLI集成镜像

镜像概述

本Docker镜像集成了HashiCorp Terraform工具和AWS CLI，提供容器化环境用于通过基础设施即代码(IaC)方式管理AWS云资源。无需在本地系统单独配置，即可直接执行Terraform资源编排和AWS服务管理操作。

核心功能与特性

• 包含HashiCorp Terraform工具，支持init、plan、apply、destroy等完整生命周期操作
• 集成AWS CLI，支持S3、EC2、VPC等AWS服务的命令行管理
• 轻量级基础镜像，优化容器体积和运行效率
• 支持多种身份验证方式，包括环境变量和挂载凭证文件
• 兼容主流Linux架构，可在开发、测试和生产环境中使用

使用场景与适用范围

• 开发环境：本地验证Terraform配置文件，测试AWS资源部署逻辑
• CI/CD流水线：集成到自动化流程，实现AWS基础设施的持续部署与更新
• 临时工作环境：快速创建隔离的Terraform操作环境，避免本地配置冲突
• 培训与演示：提供标准化的工具环境，用于IaC教学和技术演示

使用方法与配置说明

基本使用（docker run）

bash
docker run -it --rm \
  -v $(pwd):/workspace \          # 挂载本地Terraform配置目录
  -v ~/.aws:/root/.aws \          # 挂载本地AWS凭证文件（可选）
  -e AWS_ACCESS_KEY_ID=your_key \ # AWS访问密钥ID（若未挂载凭证）
  -e AWS_SECRET_ACCESS_KEY=your_secret \ # AWS密钥（若未挂载凭证）
  hashicorp/terraform-aws-cli:latest \
  sh

容器内执行命令示例：

bash
# 初始化Terraform项目
terraform init

# 生成部署计划
terraform plan

# 应用资源部署
terraform apply

# 查看AWS S3存储桶列表
aws s3 ls

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  terraform-aws:
    image: hashicorp/terraform-aws-cli:latest
    volumes:
      - ./terraform:/workspace  # 本地Terraform配置目录
      - ~/.aws:/root/.aws       # AWS凭证目录
    environment:
      - AWS_REGION=us-east-1    # 默认AWS区域
      - AWS_DEFAULT_OUTPUT=json # CLI输出格式
    working_dir: /workspace
    tty: true

启动并进入容器：

bash
docker-compose up -d
docker-compose exec terraform-aws sh

配置参数说明

环境变量

挂载点

注意事项

• 确保AWS凭证具有执行所需操作的权限
• 建议使用Terraform远程后端（如S3+DynamoDB）管理状态文件，避免容器销毁导致数据丢失
• 定期更新镜像以获取工具的最新安全补丁和功能更新