Terrakube Executor 镜像文档

1. 镜像概述和主要用途

Terrakube 是一个开源协作平台，旨在通过 Terraform 运行远程基础设施即代码（Infrastructure as Code）操作，作为 Terraform Enterprise、Scalr、Env0 等闭源工具的完整替代方案。本镜像为 Terrakube 平台的 Executor 组件，负责执行具体的 Terraform 任务，是 Terrakube 完整部署的核心组成部分。

2. 核心功能和特性

2.1 平台核心特性

• 开源替代方案：提供闭源工具的开源替代，降低基础设施管理成本。
• Kubernetes 部署支持：可轻松部署在任何 Kubernetes 集群中，适应容器化环境。
• 高度可扩展性：支持集成多种开源 Terraform 工具（如 terratag、infracost、terrascan 等），自定义平台功能。
• 多认证集成：通过 Dex 支持多种认证提供商，包括 Azure Active Directory、Google Cloud Identity、GitHub、GitLab 等。

2.2 Executor 组件特性

• 负责执行远程 Terraform 任务，处理基础设施代码的计划、应用等操作。
• 与 Terrakube 其他组件协同工作，确保任务调度和执行的高效性。

3. 使用场景和适用范围

3.1 适用场景

• 企业级团队需要远程管理 Terraform 工作流，替代闭源工具以降低成本。
• 需在自有 Kubernetes 集群中部署基础设施即代码管理平台。
• 需要自定义 Terraform 工具链，集成成本分析、安全扫描等功能。
• 需支持多团队、多认证源的协作环境。

3.2 适用范围

• 中小型至大型企业的 DevOps 团队。
• 采用 Kubernetes 作为容器编排平台的组织。
• 依赖 Terraform 进行基础设施管理的技术团队。

4. 使用方法和配置说明

4.1 部署建议

本镜像仅为 Terrakube Executor 组件，建议作为 Terrakube 完整部署的一部分使用。完整部署可通过以下方式实现：

4.1.1 Docker Compose 部署

参考官方 Docker Compose 部署指南，通过 Docker Compose 快速部署包含 Executor 在内的完整 Terrakube 平台。

4.1.2 Helm Chart 部署

通过 Terrakube Helm Chart 在 Kubernetes 集群中部署，支持生产环境级别的配置和扩展。

4.2 配置参数说明

Executor 组件的详细配置参数（如环境变量、任务超时设置等）需结合 Terrakube 完整部署进行配置，具体参考 官方文档 中的配置指南。

5. 支持的标签和架构

5.1 支持的标签

• 2.17.0, 2.18.0, 2.19.0, 2.20.0, 2.21.0, latest
  （对应 Dockerfile 链接：GitHub）

5.2 支持的架构

• linux/amd64
• linux/arm64

6. 许可信息

镜像中软件的许可信息详见 Terrakube 开源许可。

7. 参考与支持

7.1 维护者

Terrakube

7.2 获取帮助

• GitHub 讨论区：AzBuilder Discussions

7.3 提交 Issue

• Issue 跟踪：[***]

7.4 官方文档

Terrakube Documentation