zndevops/terraform-python-aws

镜像概述

本镜像基于官方Terraform基础镜像构建，额外集成了python3、aws-cli和yarn工具链，旨在提供一站式环境，减少用户在基础设施即代码（IaC）管理过程中手动安装依赖的操作，适用于需要同时使用这些工具的开发和部署场景。

核心功能与特性

核心组件

• Terraform：官方稳定版本，支持基础设施的定义、部署和管理
• python3：提供Python运行环境，支持执行基础设施配置相关的Python脚本
• aws-cli：AWS命令行工具，可直接在容器内执行AWS云资源操作
• yarn：JavaScript包管理器，支持前端项目依赖管理及资源构建

特性优势

• 工具链集成：无需在多个容器间切换，同一环境完成基础设施管理、云服务操作、脚本执行和前端构建
• 轻量级设计：在保证功能完整性的同时优化镜像体积，缩短拉取和启动时间
• 版本兼容性：各组件版本经过验证，确保基础功能稳定运行

使用场景

云基础设施部署

结合Terraform和aws-cli，在AWS云平台上执行基础设施的创建、更新和销毁操作，适用于需要直接与AWS API交互的场景。

自动化脚本集成

通过python3编写基础设施配置验证、动态参数生成等脚本，与Terraform配置文件联动，实现更灵活的IaC管理。

全栈项目基础设施管理

在需要同时处理后端基础设施（Terraform）和前端资源构建（yarn）的全栈项目中，统一工具链环境，简化部署流程。

CI/CD流水线集成

作为CI/CD流程中的执行环境，完成基础设施代码的 lint、验证、部署及前端资源打包等连贯操作。

使用方法

基本使用

通过以下命令启动容器并进入交互式终端：

bash
docker run -it --rm [镜像名称]:[标签] /bin/bash

进入容器后可直接使用各工具：

bash
# 验证Terraform版本
terraform --version

# 验证aws-cli版本
aws --version

# 验证python3版本
python3 --version

# 验证yarn版本
yarn --version

挂载本地目录

挂载本地Terraform配置文件或项目代码至容器内：

bash
docker run -it --rm \
  -v $(pwd):/workspace \
  -w /workspace \
  [镜像名称]:[标签] \
  /bin/bash

参数说明：

• -v $(pwd):/workspace：将当前目录挂载至容器内/workspace路径
• -w /workspace：设置工作目录为/workspace，直接操作挂载的本地文件

配置AWS凭证

通过环境变量或挂载配置文件方式配置AWS凭证（生产环境推荐后者）：

环境变量方式（测试场景）：

bash
docker run -it --rm \
  -e AWS_ACCESS_KEY_ID=your_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret_key \
  -e AWS_REGION=us-west-2 \
  [镜像名称]:[标签] \
  aws s3 ls  # 示例：列出S3存储桶

配置文件方式（生产场景）：

bash
docker run -it --rm \
  -v ~/.aws:/root/.aws \
  [镜像名称]:[标签] \
  aws ec2 describe-instances  # 示例：查询EC2实例

持久化数据

通过数据卷持久化Terraform状态文件和工具配置：

bash
# 创建数据卷
docker volume create terraform-data

# 使用数据卷启动容器
docker run -it --rm \
  -v terraform-data:/root/.terraform \
  [镜像名称]:[标签] \
  /bin/bash

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  terraform-env:
    image: [镜像名称]:[标签]
    volumes:
      - ./terraform-config:/workspace        # 挂载本地配置文件
      - ~/.aws:/root/.aws                    # 挂载AWS凭证（可选）
      - terraform-data:/root/.terraform      # 持久化Terraform数据
    environment:
      - AWS_REGION=us-east-1                 # 默认AWS区域（可选）
    tty: true
    stdin_open: true

volumes:
  terraform-data:  # 持久化数据卷

启动服务：

bash
docker-compose up -d
docker-compose exec terraform-env /bin/bash

注意事项

• 镜像标签：建议使用具体版本标签（如:1.6.0-py3.11-aws2.13-yarn1.22）以确保环境一致性
• 敏感信息：生产环境中避免使用明文环境变量传递凭证，优先采用密钥文件挂载或容器编排平台的密钥管理功能
• 版本更新：定期更新镜像以获取Terraform及各工具的安全补丁和功能更新