forge 的项目扩展与二次开发

项目的基础介绍

Forge 是一个开源的、生产级别的平台，用于在 AWS 上为多个租户运行临时的 GitHub Actions 运行器，它具备内置的自动化、安全和可观察性。Forge 由平台工程师构建，旨在为平台团队提供一个安全、高效且可扩展的 CI 运行器，同时为租户团队带来零运营成本的优势。

项目的核心功能

• 临时运行器（Ephemeral Runners）：自动扩展 EC2/EKS 运行器，无需支付空闲成本。
• 租户隔离（Tenant Isolation）：通过 IAM、OIDC 和 VPC 边界为每个租户提供隔离。
• 零触操作（Zero-Touch Ops）：自动进行偏差修复、补丁、升级和入门引导。
• 内置可观察性（Built-in Observability）：提供日志、指标和仪表板。
• 成本优化（Cost Optimization）：使用现货实例、缩放到零和暖池逻辑来优化成本。
• 自定义基础设施（Customizable Infra）：支持使用自定义 AMI、子网和实例类型。
• 多运行器支持（Multi-Runner Support）：在一个模块中部署多个运行器类型。
• 多操作系统支持（Multi-OS）：支持 Linux (x64/arm64) 和 Windows。
• 支持 GitHub Cloud 和 GHES：适用于不同的托管模型。

项目使用了哪些框架或库？

Forge 结合了以下两个经过验证的开源项目，并增加了额外的价值：

• terraform-aws-github-runner：用于创建 AWS 上的 GitHub Actions 运行器。
• actions-runner-controller：用于管理 GitHub Actions 运行器。

此外，Forge 使用了以下技术和库：

• OpenTofu/Terraform：用于基础设施即代码。
• Helm：用于部署和管理 Kubernetes 应用程序。
• AWS IAM + OIDC：用于安全地注册运行器。

项目的代码目录及介绍

项目的代码目录结构如下：

• .docker/：包含 Docker 相关的配置和文件。
• .github/：包含 GitHub Actions 的工作流文件。
• build/：构建脚本和配置文件。
• docs/：项目的文档。
• examples/：使用 Forge 的示例配置。
• modules/：定义不同租户配置的模块。
• scripts/：辅助脚本。
• CODE_OF_CONDUCT.md：项目行为准则。
• CONTRIBUTING.md：贡献指南。
• LICENSE：项目许可证。
• README.md：项目说明文件。
• SECURITY.md：安全策略。

对项目进行扩展或者二次开发的方向

1. 增强租户隔离：可以通过定制 IAM 策略和 OIDC 身份验证，为租户提供更细粒度的访问控制。
2. 扩展监控和日志：整合更多的监控工具和日志管理系统，提高系统的可观察性。
3. 优化成本管理：实现更智能的成本优化策略，例如根据工作负载自动选择实例类型。
4. 支持更多的运行器类型和操作系统：增加对更多 GitHub Actions 运行器类型和操作系统的支持，以满足不同用户的需求。
5. 增加自动化运维功能：自动化更多运维任务，如自动化的故障恢复、性能调优等。