etsinfra/docker-terraform-plus

docker-terraform-plus 镜像文档

镜像概述

docker-terraform-plus是一个集成化Docker镜像，包含Terraform工具、Aiven插件、python3-pip包管理工具及其他实用组件。该镜像旨在提供一站式基础设施即代码（IaC）操作环境，减少用户单独安装和配置多个工具的复杂性，特别适用于需要管理Aiven服务或结合Python脚本进行基础设施自动化的场景。

核心功能与特性

• 集成Terraform：包含最新稳定版Terraform，支持标准IaC操作（如初始化、计划、应用、销毁等）。
• Aiven插件预安装：内置Aiven官方Terraform插件，可直接用于管理Aiven服务（如Kafka、PostgreSQL、Redis等）。
• Python环境支持：包含python3及pip包管理工具，支持运行Python脚本，扩展基础设施自动化能力。
• 额外实用工具：集成常用系统工具，满足日常运维和开发需求。

使用场景

• Aiven服务管理：通过Terraform快速定义、部署和管理Aiven云服务资源。
• 多工具协同场景：需要同时使用Terraform和Python进行基础设施编排与自动化脚本开发的场景。
• 快速部署IaC环境：无需在本地或服务器手动配置Terraform、Aiven插件及Python环境，直接通过容器启动即用。
• CI/CD集成：作为CI/CD流程中的执行环境，用于自动化基础设施部署和验证。

使用方法与配置说明

基本使用（docker run）

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

bash
docker run -it --rm [OPTIONS] docker-terraform-plus

常用选项说明：

• -v /path/to/local/terraform/files:/workspace：挂载本地Terraform项目目录到容器内的/workspace，实现配置文件持久化和编辑。
• -e TF_VAR_aiven_api_token=your_token：设置环境变量，传递Aiven API令牌等敏感信息（推荐使用环境变量而非硬编码）。

执行Terraform命令示例

在容器内执行标准Terraform操作：

bash
# 进入工作目录
cd /workspace

# 初始化Terraform项目（加载Aiven插件）
terraform init

# 生成执行计划
terraform plan

# 应用配置
terraform apply

运行Python脚本示例

利用内置python3-pip安装依赖并执行脚本：

bash
# 安装Python依赖（如requests库）
pip install requests

# 执行Python脚本
python your_script.py

docker-compose配置示例

创建docker-compose.yml文件，定义持久化工作目录和环境变量：

yaml
version: '3'
services:
  terraform:
    image: docker-terraform-plus
    volumes:
      - ./terraform-project:/workspace
    environment:
      - TF_VAR_aiven_api_token=${AIVEN_API_TOKEN}
    tty: true

启动服务：

bash
AIVEN_API_TOKEN=your_actual_token docker-compose up -d

进入容器：

bash
docker-compose exec terraform bash