stekovic/terraform-ci

Terraform辅助工具集成镜像

镜像概述

本镜像基于Debian系统构建，集成了Terraform核心工具及多种实用辅助工具，旨在为基础设施即代码（IaC）开发提供一站式环境。通过整合Terraform、tflint、terraform-docs和Checkov，简化IaC项目的开发、质量检查、安全验证及文档生成流程。

核心功能和特性

• Terraform：官方Terraform二进制程序，支持基础设施资源编排与管理
• tflint：Terraform代码静态分析工具，检测语法错误、最佳实践违规及潜在问题
• terraform-docs：自动生成Terraform模块文档，支持多种输出格式（Markdown、JSON等）
• Checkov：IaC安全扫描工具，识别云资源配置中的安全漏洞和合规风险
• Debian基础：基于稳定的Debian系统，确保工具兼容性和运行稳定性

使用场景和适用范围

• IaC项目开发：本地开发Terraform配置文件时提供完整工具链
• 代码质量检查：通过tflint进行代码规范性和最佳实践验证
• 安全合规验证：使用Checkov扫描配置文件中的安全风险
• 文档自动化：通过terraform-docs自动生成模块文档，提升项目可维护性
• CI/CD集成：作为CI/CD流水线中的基础镜像，实现自动化检查与部署

使用方法和配置说明

基本使用（Docker Run）

bash
# 运行Terraform命令
docker run --rm -v $(pwd):/workspace -w /workspace [镜像名称] terraform init

# 运行tflint检查
docker run --rm -v $(pwd):/workspace -w /workspace [镜像名称] tflint

# 生成Terraform文档
docker run --rm -v $(pwd):/workspace -w /workspace [镜像名称] terraform-docs markdown table --output-file README.md .

# 运行Checkov安全扫描
docker run --rm -v $(pwd):/workspace -w /workspace [镜像名称] checkov -d .

Docker Compose配置示例

yaml
version: '3'
services:
  terraform-tools:
    image: [镜像名称]
    volumes:
      - ./terraform:/workspace
    working_dir: /workspace
    command: terraform plan

关键配置说明

• 数据卷挂载：通过-v $(pwd):/workspace将本地Terraform项目目录挂载到容器内，实现文件共享
• 工作目录设置：使用-w /workspace指定容器内工作目录，确保命令在项目根目录执行
• 工具参数：可直接在命令后追加工具原生参数，如terraform plan -var-file=prod.tfvars、tflint --init等

环境变量支持

可通过-e参数传递环境变量，如Terraform云平台认证信息：

bash
docker run --rm -v $(pwd):/workspace -w /workspace \
  -e TF_VAR_access_key=your_access_key \
  -e TF_VAR_secret_key=your_secret_key \
  [镜像名称] terraform apply