actions/actions-runner-controller

これは何？

主な機能

• 01キューに入ったworkflowジョブと実行中のworkflowジョブに応じて、runner scale setを自動スケーリングします。
• 02Kubernetes上で一時的なコンテナ型runnerを実行します。
• 03Helm chartでインストールできます。
• 04リポジトリ、organization、enterprise単位で登録されたrunnerに対応しています。

ユースケース

• GitHub-hosted runnerの代わりに、自分のクラスターでCIジョブを実行する。
• ピーク時にビルド容量を増やし、アイドル時に減らす。
• 各ジョブを新しいコンテナで分離し、ビルド環境をクリーンに保つ。

クイックスタート

1. 1

   READMEにリンクされているQuickstartガイドに従って、Kubernetesクラスターをセットアップし、HelmでARCをインストールします

2. 2

   デプロイメントドキュメントの説明に従って、runner scale setを作成し、それを使用するworkflowを実行します

使う前に知っておきたいこと

• !Kubernetesクラスターが必要なため、Kubernetesを使用しない環境には適していません。
• !レガシーのオートスケーリングモードは、GitHubではなくコミュニティによってのみメンテナンスされています。

収録されている特集

トピック

よくある質問

actions-runner-controller とは？

一時コンテナとしてセルフホスト型GitHub Actions runnerを実行し、自動スケーリングするKubernetes operator。 Actions Runner Controller（ARC）は、GitHub Actions用のセルフホスト型runnerを実行するKubernetes operatorです。リポジトリ、organization、enterpriseで実行中のworkflow数に応じて増減するrunner scale setを作成します。

actions-runner-controller は無料で使えますか？ライセンスは？

actions-runner-controller は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

actions-runner-controller は今もメンテナンスされていますか？

活発にメンテナンス中。actions-runner-controller の最終コミットは 2026年11月2日 です。

actions-runner-controller は何に使えますか？

GitHub-hosted runnerの代わりに、自分のクラスターでCIジョブを実行する。 ピーク時にビルド容量を増やし、アイドル時に減らす。 各ジョブを新しいコンテナで分離し、ビルド環境をクリーンに保つ。

actions-runner-controller のインストール方法は？

READMEにリンクされているQuickstartガイドに従って、Kubernetesクラスターをセットアップし、HelmでARCをインストールします デプロイメントドキュメントの説明に従って、runner scale setを作成し、それを使用するworkflowを実行します

actions-runner-controller はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/actions/actions-runner-controller