mtomadyciuser/terraform

docker-terraform 镜像文档

镜像概述

docker-terraform是一个扩展的Terraform Docker容器，基于官方Terraform镜像构建，额外集成了make和tflint工具。该镜像旨在提供一站式的Terraform开发环境，简化项目构建流程并增强代码质量检查能力。

核心功能与特性

• 基础兼容性：基于官方Terraform镜像，确保与Terraform核心功能完全兼容
• 构建自动化：集成make工具，支持通过Makefile实现Terraform项目的构建、部署流程自动化
• 代码质量检查：集成tflint工具，提供Terraform代码的静态分析和 lint 检查，识别潜在问题和最佳实践违规

使用场景

• 本地开发环境：无需在主机系统安装Terraform、make和tflint，直接通过容器化方式进行Terraform项目开发
• CI/CD集成：在持续集成/持续部署流水线中使用，标准化工具链版本，确保构建和检查流程一致性
• 多环境统一：为开发、测试和生产环境提供相同的工具配置，减少"在我机器上能运行"的环境差异问题

使用方法与配置说明

基本使用

通过docker run命令启动容器，挂载本地Terraform项目目录：

bash
docker run -v /path/to/your/terraform/project:/workspace -w /workspace docker-terraform [command]

示例1：执行tflint代码检查

bash
docker run -v /path/to/your/terraform/project:/workspace -w /workspace docker-terraform tflint

示例2：执行make命令（假设项目中存在Makefile）

bash
docker run -v /path/to/your/terraform/project:/workspace -w /workspace docker-terraform make plan

示例3：直接运行Terraform命令

bash
docker run -v /path/to/your/terraform/project:/workspace -w /workspace docker-terraform terraform init

持久化配置

如需使用自定义tflint配置，可将配置文件挂载到容器中：

bash
docker run -v /path/to/your/terraform/project:/workspace \
           -v /path/to/your/.tflint.hcl:/root/.tflint.hcl \
           -w /workspace \
           docker-terraform tflint

docker-compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  terraform:
    image: docker-terraform
    volumes:
      - ./terraform-project:/workspace
      - ./tflint-config:/root/.tflint.hcl
    working_dir: /workspace
    command: tflint

启动服务：

bash
docker-compose up