eerkunt/terraform-compliance

terraform-compliance

Terraform文件的BDD测试工具
项目地址：https://github.com/eerkunt/terraform-compliance

镜像概述

terraform-compliance是一款基于行为驱动开发（BDD）的工具，专为Terraform基础设施即代码（IaC）设计，用于在部署前对配置文件进行验证和合规性检查，确保团队遵循预设策略。

核心功能与特性

• 合规性测试：在部署前测试基础设施即代码，强制团队遵循策略规范。
• 行为驱动开发：将BDD理念应用于IaC领域，通过.feature文件定义测试场景。
• 预置步骤：工具内置固定测试步骤，用户只需关注BDD特性/场景文件编写。
• 便携性：支持通过pip安装或使用Docker镜像，无需复杂环境配置。

使用场景

适用于需要对Terraform配置进行合规性验证的场景，包括：

• 本地Terraform项目文件的合规性检查
• 远程Git仓库中Terraform代码与合规性规则的验证
• 团队协作中确保基础设施配置符合组织策略

使用方法与配置说明

基本参数说明

• -f：指定BDD特性文件路径（本地目录或远程Git仓库URL，格式为git:<URL>）
• -t：指定Terraform文件路径（本地目录或远程Git仓库URL，格式为git:<URL>）

本地文件验证

当特性文件和Terraform文件位于本地时，需通过-v参数挂载本地目录至容器的/target路径：

bash
[~] $ docker run --rm -v $PWD:/target -i -t eerkunt/terraform-compliance \
                                            -f example/example_01 \
                                            -t example/tf_files

说明：$PWD为当前工作目录，将本地文件挂载到容器内的/target目录，-f指定本地特性文件路径，-t指定本地Terraform文件路径。

远程Git仓库验证

当特性文件和Terraform文件存储在远程Git仓库时，无需挂载本地目录，直接通过git:<URL>指定路径：

bash
[~] $ docker run --rm -i -t eerkunt/terraform-compliance \
                            -f git:https://some.git.repository/compliance-code.git \
                            -t git:https://some.git.repository/terraform-repo.git

说明：-f指定远程合规性规则仓库URL，-t指定远程Terraform代码仓库URL，工具将自动拉取并执行检查。