actions/actions-runner-controller
GitHub: actions/actions-runner-controller
在 Kubernetes 集群中自动编排和弹性扩展 GitHub Actions 自托管 runner 的控制器
Stars: 6068 | Forks: 1385
# Actions Runner Controller (ARC)
[](https://bestpractices.coreinfrastructure.org/projects/6061)
[](https://github.com/jonico/awesome-runners)
[](https://artifacthub.io/packages/search?repo=actions-runner-controller)
## 关于
Actions Runner Controller (ARC) 是一个 Kubernetes operator,用于编排和扩展 GitHub Actions 的自托管 runner。
使用 ARC,你可以创建 runner scale set,它可以根据你的仓库、组织或企业中运行的工作流数量自动扩展。由于受控的 runner 可以是临时的且基于容器,新的 runner 实例可以快速且干净地扩容或缩容。有关自动扩展的更多信息,请参阅[“使用自托管 runner 进行自动扩展”。](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners/autoscaling-with-self-hosted-runners)
你可以使用 Helm 在 Kubernetes 上设置 ARC,然后创建并运行使用 runner scale set 的工作流。有关 runner scale set 的更多信息,请参阅[“使用 Actions Runner Controller 部署 runner scale set”。](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/deploying-runner-scale-sets-with-actions-runner-controller#runner-scale-set)
## 团队
Actions Runner Controller (ARC) 是一个开源项目,目前由 GitHub Actions 团队、外部维护者 @mumoshu 和 @toast-gear、各位[贡献者](https://github.com/actions/actions-runner-controller/graphs/contributors)以及[很棒的社区](https://github.com/actions/actions-runner-controller/discussions)协作开发和维护。
## 快速开始
若要通过少量命令快速试用 ARC,请参阅[快速入门指南](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/quickstart-for-actions-runner-controller)。
有关 ARC 的概述,请参阅[关于 ARC](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/about-actions-runner-controller)。
随着[自动扩展 runner scale set](https://github.com/actions/actions-runner-controller/discussions/2775) 的引入,现有的[自动扩展模式](./docs/automatically-scaling-runners.md) 现已成为旧版。旧版模式具有某些特定用例,并将仅由社区继续维护。
有关 GitHub 支持的内容和社区管理的内容的更多信息,请参阅[此公告讨论。](https://github.com/actions/actions-runner-controller/discussions/2775)
### 文档
ARC 文档可在 [docs.github.com](https://docs.github.com/en/actions/hosting-your-own-runners/managing-self-hosted-runners-with-actions-runner-controller/quickstart-for-actions-runner-controller) 上获取。
### 旧版文档
以下文档适用于由社区继续维护的旧版自动扩展模式:
- [快速入门指南](/docs/quickstart.md)
- [关于 ARC](/docs/about-arc.md)
- [安装 ARC](/docs/installing-arc.md)
- [向 GitHub API 进行身份验证](/docs/authenticating-to-the-github-api.md)
- [部署 ARC runner](/docs/deploying-arc-runners.md)
- [将 ARC runner 添加到仓库、组织或企业](/docs/choosing-runner-destination.md)
- [自动扩展 runner](/docs/automatically-scaling-runners.md)
- [使用自定义卷](/docs/using-custom-volumes.md)
- [在工作流中使用 ARC runner](/docs/using-arc-runners-in-a-workflow.md)
- [使用 runner group 管理访问权限](/docs/managing-access-with-runner-groups.md)
- [配置 Windows runner](/docs/configuring-windows-runners.md)
- [跨组织使用 ARC](/docs/using-arc-across-organizations.md)
- [使用 entrypoint 功能](/docs/using-entrypoint-features.md)
- [部署替代 runner](/docs/deploying-alternative-runners.md)
- [监控和故障排除](/docs/monitoring-and-troubleshooting.md)
## 贡献
我们欢迎社区的贡献。有关为项目做贡献的更多详细信息(包括要求),请参阅“[开始贡献](https://github.com/actions/actions-runner-controller/blob/master/CONTRIBUTING.md)”。
## 故障排除
我们非常乐意帮助您解决遇到的任何问题。有关常见问题,请参阅“[故障排除](https://github.com/actions/actions-runner-controller/blob/master/TROUBLESHOOTING.md)”部分。
标签:Autoscaling, DNS解析, Ephemeral Runner, EVTX分析, EVTX分析, EVTX分析, GitHub Actions, Helm Chart, Operator, Runner Scale Set, Self-hosted Runner, Workflow Automation, 子域名突变, 容器编排, 开源框架, 开源项目, 持续部署, 持续集成, 控制器, 日志审计, 自动扩缩容, 自动笔记, 请求拦截