rrey/terraform-runner

rrey/terraform-runner

!https://github.com/rrey/terraform-runner/workflows/Docker%20Image%20CI/badge.svg

镜像概述和主要用途

该Docker镜像旨在作为CI运行器，用于处理Terraform内容。它集成了一系列围绕Terraform的实用工具，提供一站式的Terraform工作流支持，适用于自动化部署、测试和合规检查场景。

核心功能和特性

镜像包含以下核心工具：

• https://terraform.io/%EF%BC%9ATerraform CLI本身，用于基础设施即代码的定义和部署
• Terragrunt：Terraform的包装器，简化分层管理和配置复用
• https://github.com/newcontext-oss/kitchen-terraform%EF%BC%9ATest Kitchen插件，支持Terraform代码的自动化测试
• Inspec：Chef的合规即代码测试框架，用于验证基础设施配置合规性
• https://www.openpolicyagent.org/%EF%BC%9A%E5%BC%80%E6%BA%90%E7%AD%96%E7%95%A5%E5%BC%95%E6%93%8E%EF%BC%8C%E9%80%9A%E8%BF%87Terraform%E8%AE%A1%E5%88%92%E5%AE%9E%E7%8E%B0%E5%9F%BA%E4%BA%8E%E7%AD%96%E7%95%A5%E7%9A%84%E6%8E%A7%E5%88%B6
• https://github.com/instrumenta/conftest%EF%BC%9A%E9%80%9A%E8%BF%87%E8%BF%90%E8%A1%8COPA%E7%AD%96%E7%95%A5%E6%B5%8B%E8%AF%95%EF%BC%8C%E7%AE%80%E5%8C%96%E7%AD%96%E7%95%A5%E9%AA%8C%E8%AF%81%E7%BB%93%E6%9E%9C%E7%9A%84%E8%A7%A3%E8%AF%BB

使用场景和适用范围

• CI/CD流水线中集成Terraform部署流程
• Terraform模块的自动化测试和验证
• 基础设施配置的合规性检查
• 多环境Terraform配置的分层管理
• 策略即代码（Policy as Code）在Terraform工作流中的实施

使用方法和配置说明

基本使用

通过挂载工作目录到容器中，执行Terraform相关命令：

bash
# 运行terraform init
docker run -v $(pwd):/workspace docker.xuanyuan.run/rrey/terraform-runner terraform init

# 运行terragrunt plan
docker run -v $(pwd):/workspace docker.xuanyuan.run/rrey/terraform-runner terragrunt plan

# 运行Inspec测试
docker run -v $(pwd):/workspace docker.xuanyuan.run/rrey/terraform-runner inspec exec test/integration

CI集成示例（GitLab CI）

在.gitlab-ci.yml中使用：

yaml
stages:
  - validate
  - test

terraform-validate:
  stage: validate
  image: docker.xuanyuan.run/rrey/terraform-runner
  script:
    - terragrunt validate

terraform-test:
  stage: test
  image: docker.xuanyuan.run/rrey/terraform-runner
  script:
    - kitchen test
    - conftest test terraform.plan

Terraform相关的其他实用工具（不在此镜像中）

• https://github.com/segmentio/terraform-docs%EF%BC%9A%E9%80%9A%E8%BF%87%E5%91%BD%E4%BB%A4%E8%A1%8C%E5%B7%A5%E5%85%B7%E8%AF%BB%E5%8F%96%E4%BB%A3%E7%A0%81%E5%B9%B6%E7%94%9F%E6%88%90%E6%B8%85%E6%99%B0%E7%9A%84Markdown%EF%BC%88%E5%8F%8A%E5%85%B6%E4%BB%96%E6%A0%BC%E5%BC%8F%EF%BC%89%E6%96%87%E6%A1%A3%EF%BC%8C%E6%B6%88%E9%99%A4%E6%A8%A1%E5%9D%97%E6%96%87%E6%A1%A3%E7%9A%84%E7%B9%81%E7%90%90%E5%B7%A5%E4%BD%9C%E3%80%82