snapkitchen/concourse-terraform

镜像概述

snapkitchen/concourse-terraform镜像为Concourse CI提供一系列任务，用于编排Terraform操作，帮助用户在CI/CD流水线中自动化基础设施即代码（IaC）的部署与管理。该镜像通过Python库封装Terraform命令，简化状态管理、变量注入、后端配置等核心流程。

核心功能

• 状态管理: 支持远程状态（通过Terraform后端）和本地状态（作为输出由Concourse资源管理），输出可在任务间传递。
• 多版本支持: 提供预构建的多版本Terraform镜像，也可通过Dockerfile自定义构建任意版本。
• 自动化策略: 支持plan与apply分离的自动化流程，生成一致路径的计划归档文件，确保跨步骤兼容性。
• 插件缓存: 利用Concourse任务缓存存储Terraform插件，减少重复下载时间。
• 灵活配置: 支持变量注入、后端动态配置、辅助输入（如CA证书、SSH密钥）等扩展功能。

使用场景

• Concourse CI流水线中的Terraform初始化、计划、应用操作。
• 基础设施的自动化部署、更新与销毁。
• 多环境（开发、测试、生产）的IaC版本控制与管理。

配置说明

指定Terraform版本

通过Concourse资源引用特定版本的镜像：

yaml
resources:
- name: concourse-terraform-image
  type: docker-image
  source:
    repository: snapkitchen/concourse-terraform
    tag: "1.5.0" # 替换为所需版本

注入变量

通过参数传递Terraform变量：

yaml
task: terraform-plan
image: concourse-terraform-image
file: concourse-terraform/tasks/plan.yaml
params:
  TF_VAR_cluster_region: "us-east-1"
  TF_VAR_cluster_name: "my-cluster"

配置后端

动态生成S3后端配置：

yaml
task: terraform-apply
image: concourse-terraform-image
file: concourse-terraform/tasks/apply.yaml
params:
  TF_BACKEND_TYPE: "s3"
  TF_BACKEND_CONFIG_bucket: "my-terraform-state-bucket"
  TF_BACKEND_CONFIG_key: "path/to/state.tfstate"
  TF_BACKEND_CONFIG_region: "us-east-1"

管理本地状态

保存状态文件到输出目录：

yaml
task: terraform-apply
image: concourse-terraform-image
file: concourse-terraform/tasks/apply.yaml
outputs:
- name: state-output-dir
params:
  STATE_FILE_PATH: "state-input-dir/terraform.tfstate" # 加载现有状态