spreetail/terrapipe Docker 镜像 - 轩辕镜像

Terrapipe 镜像文档

1. 镜像概述与主要用途

Terrapipe是一个构建环境镜像，集成了一系列工具，旨在帮助开发人员通过GitLab CI和DevContainers安全高效地构建、变更和版本控制基础设施。该镜像为基础设施即代码（IaC）开发提供了统一的工具链支持，简化开发流程并确保环境一致性。

2. 核心功能与包含工具

2.1 核心功能

• 提供完整的基础设施开发工具链，支持从代码编写到部署的全流程
• 与GitLab CI深度集成，支持自动化CI/CD流水线
• 兼容DevContainers，支持本地开发环境标准化

2.2 包含工具列表

• terraform：基础设施即代码工具
• terraform-docs：生成Terraform文档的工具
• terragrunt：Terraform封装工具，简化多环境管理
• tflint：Terraform代码检查工具
• azure-cli：Azure云服务命令行工具
• python：编程语言，支持脚本开发
• go：编程语言，支持工具开发
• kubectl：Kubernetes命令行工具
• helm：Kubernetes包管理工具
• gitlab-terraform：GitLab Terraform集成脚本

3. 使用场景与适用范围

• GitLab CI/CD流水线：用于自动化执行Terraform计划、应用、验证等操作
• 本地开发环境：通过DevContainers提供一致的开发环境，避免"本地环境不一致"问题
• 多平台基础设施管理：支持Azure云、Kubernetes等多种平台的基础设施开发
• 团队协作：确保团队成员使用统一的工具版本，减少环境差异导致的问题

4. 使用方法与配置说明

4.1 基本使用

运行容器无需额外配置，直接启动即可使用内置工具：

bash
docker run --rm -it spreetail/terrapipe:<version>

4.2 本地开发配置

推荐使用VSCode Remote Containers进行本地开发：

1. 在项目中创建.devcontainer目录
2. 配置devcontainer.json文件指定使用Terrapipe镜像
3. 通过VSCode打开项目，自动加载容器环境

4.3 GitLab CI集成

在.gitlab-ci.yml中使用该镜像作为CI执行环境：

yaml
stages:
  - validate
  - plan

validate:
  stage: validate
  image: spreetail/terrapipe:<version>
  script:
    - terraform init
    - terraform validate
    - tflint

plan:
  stage: plan
  image: spreetail/terrapipe:<version>
  script:
    - gitlab-terraform plan

5. 配置说明

运行容器无需额外配置。所有工具已预安装并配置完成，可直接使用。对于特定需求，可通过挂载本地目录或设置环境变量进行自定义。