cmdlabs/terraform-utils

docker-terraform-utils

镜像概述

docker-terraform-utils是一个集成了terraform、aws-cli和terraform-docs工具的Docker镜像。该镜像主要用于遵循3 Musketeers模式，通过在Docker容器中运行这些工具，确保开发和部署过程中的一致性、版本控制和可靠性。

核心功能和特性

• 一致性：在开发使用terraform的自动化流程时，无论在Windows工作站还是Jenkins构建代理上运行，都能确保功能一致。
• 版本控制：通过在[docker-compose.yml][]中指定镜像版本，可以同时部署两个不兼容版本的Terraform。
• 部署信心：可靠的部署流程增强对CI/CD管道的信心，形成鼓励开发者使用CI/CD的正向反馈循环。

使用场景和适用范围

• 开发依赖terraform的自动化部署流程
• 需要跨平台（如本地开发环境与CI/CD服务器）保持工具版本一致的场景
• 需同时管理多个Terraform版本的项目
• 构建基于CI/CD的基础设施即代码(IaC)部署流程

使用方法和配置说明

基本使用配置

Makefile

创建Makefile以简化命令执行：

Makefile
deploy:
	docker-compose run --rm terraform apply

docker-compose.yml

配置docker-compose服务：

yaml
services:
  terraform:
    image: cmdlabs/terraform-utils:6.0.0  # 指定镜像版本
    volumes:
      - .:/work:Z  # 将当前目录挂载到容器内的/work目录，确保文件访问权限

使用步骤

1. 确保已安装Docker和Docker Compose
2. 创建上述Makefile和docker-compose.yml文件
3. 执行make deploy命令，将通过容器运行terraform apply

核心命令说明

• docker-compose run --rm terraform <command>：在容器中运行指定的terraform命令，--rm确保命令执行后容器自动删除
• 可替换<command>为任意terraform命令（如plan、destroy、init等），或使用aws-cli、terraform-docs命令

版本控制

通过修改docker-compose.yml中的image标签指定具体版本（如6.0.0），实现不同环境的版本隔离和控制。