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