Note
この記事の情報と手順は、Linux または Windows オペレーティング システムを搭載した より大きなランナー にのみ適用されます。
ランナー グループについて
Organization レベルでは、GitHub Team プランを使っている Organization は、ランナー グループを使用できます。ランナー グループは、ランナーのセットを収集し、その周囲にセキュリティ境界を作成するために使用されます。
ランナー グループにアクセス権を付与すると、そのランナー グループが オーガニゼーションのランナー設定に表示されます。 必要に応じて、リポジトリの詳細な追加アクセス ポリシーを、ランナー グループに割り当てることができます。
特に指定がなければ、新しいランナーが作成されると、自動的に既定のグループに割り当てられます。 ランナーは一度に1つのグループにのみ参加できます。 ランナーは、別のランナー グループに移動できます。 詳しくは、「ランナーをグループに移動する」をご覧ください。
特定のグループのランナーにジョブをルーティングする方法についての情報は、「ジョブのランナーを選択する」を参照してください。
ランナーへのアクセスの管理
Note
ワークフローがより大きなランナーにジョブを送信できるようにするには、まずランナー グループのアクセス許可を構成する必要があります。 詳しくは、以下のセクションをご覧ください。
ランナー グループは、より大きなランナーでジョブを実行できるリポジトリを制御するために使用されます。 より大きなランナーを定義した場所に応じて、管理階層の各レベルからグループへのアクセス権を管理する必要があります。
- エンタープライズ レベルのランナー: 既定では、Organization 内のリポジトリは Enterprise レベルのランナー グループにアクセスできません。 リポジトリに Enterprise ランナー グループへのアクセス権を付与するには、Organization の所有者が各 Enterprise ランナー グループを構成し、アクセスできるリポジトリを選ぶ必要があります。
- 組織レベルのランナー: 既定では、Organization 内のすべてのリポジトリに、Organization レベルのランナー グループへのアクセス権が付与されます。 アクセスできるリポジトリを制限するには、Organization の所有者が Organization ランナー グループを構成し、アクセスできるリポジトリを選ぶ必要があります。
たとえば、次の図には、Enterprise レベルに grp-ubuntu-20.04-16core
という名前のランナー グループがあります。 octo-repo
という名前のリポジトリがグループ内のランナーを使用できるようにするには、まず、octo-org
組織へのアクセスを許可するようにエンタープライズ レベルでグループを構成する必要があります。 次に、octo-repo
へのアクセスを許可するように組織レベルでグループを構成する必要があります。
Organization のランナー グループを作成する
Warning
固定 IP 範囲を使っている場合、プライベート リポジトリには より大きなランナー のみを使うことをお勧めします。 ワークフロー内でコードを実行する pull request を作成することで、リポジトリのフォークによって、より大きなランナー 上で危険なコードが実行される可能性があります。
Note
ランナー グループを作成するときは、ランナー グループにアクセスできるリポジトリが定義されているポリシーを選ぶ必要があります。 ランナー グループにアクセスできるリポジトリとワークフローを変更するには、Organization の所有者が Organization のポリシーを設定できます。 詳しくは、「エンタープライズで GitHub Actions のポリシーを適用する」を参照してください。
すべての Organization には、単一の既定のランナー グループがあります。 GitHub Team プランを使用している Organization の所有者は、追加の Organization レベルのランナー グループを作成できます。
登録プロセスでグループを指定しなかった場合、ランナーは自動的に既定のグループに追加されます。 後で、ランナーを既定のグループからカスタム グループに移動することができます。 詳しくは、「ランナーをグループに移動する」をご覧ください。
REST API を使ってランナー グループを作成する方法について詳しくは、「GitHub Actions 用の REST API エンドポイント」をご覧ください。
-
GitHub で、organization のメイン ページに移動します。
-
組織名の下で、 [設定] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。
-
左サイドバーにある [アクション] をクリックし、 [ランナー グループ] をクリックします。
-
"ランナー グループ" セクションで、 [新しいランナー グループ] をクリックします。
-
ランナー グループの名前を入力します。
-
リポジトリ アクセスのポリシーを割り当てます。
ランナー グループは、特定のリストのリポジトリまたは組織のすべてのリポジトリにアクセスできるように構成できます。 既定では、ランナー グループのランナーにアクセスできるのはプライベート リポジトリのみですが、これはオーバーライドできます。 エンタープライズによって共有された組織のランナー グループを構成する場合、この設定をオーバーライドすることはできません。
-
[グループの作成] をクリックしてグループを作成し、ポリシーを適用します。
ランナー グループにアクセスできるリポジトリを変更する
Warning
固定 IP 範囲を使っている場合、プライベート リポジトリには より大きなランナー のみを使うことをお勧めします。 ワークフロー内でコードを実行する pull request を作成することで、リポジトリのフォークによって、より大きなランナー 上で危険なコードが実行される可能性があります。
組織のランナー グループの場合、組織内のどのリポジトリがランナー グループにアクセスできるかを変更できます。
- ランナー グループが配置されている組織のメイン ページに移動します。
- [ 設定] をクリックします。
- 左サイドバーにある [アクション] をクリックし、 [ランナー グループ] をクリックします。
- グループのリストで、構成するランナー グループをクリックします。
- 「リポジトリ アクセス」で、ドロップダウン メニューを使って [選択したリポジトリ] をクリックします。
- ドロップダウン メニューの右側にある をクリックします。
- ポップアップで、チェックボックスを使って、このランナー グループにアクセスできるリポジトリを選択します。
- [グループの保存] をクリックします。
より大きなランナーのプライベート ネットワーク アクセスの構成
Azure VNET での GitHub ホストランナーを使用できます。 これにより、ランナーのネットワーク ポリシーを完全に制御しながら、CI/CD の GitHub マネージド インフラストラクチャを利用することができます。 Azure VNET の詳細については、Azure ドキュメントの「Azure Virtual Network とは」を参照してください。
組織を Azure VNET に接続するように構成している場合は、ランナー グループに仮想ネットワークへのアクセスを許可できます。 詳しくは、「GitHub ホスト ランナーを使用したプライベート ネットワークについて」を参照してください。
ランナー グループの名前を変更する
- ランナー グループが配置されている組織のメイン ページに移動します。
- [ 設定] をクリックします。
- 左サイドバーにある [アクション] をクリックし、 [ランナー グループ] をクリックします。
- グループのリストで、構成するランナー グループをクリックします。
- [グループ名] のテキスト フィールドに新しいランナー グループ名を入力します。
- [保存] をクリックします。
ランナーをグループに移動する
登録プロセス中にランナー グループを指定しない場合、新しいランナーは、自動的に既定のグループに割り当てられ、その後別のグループへの移動が可能となります。
-
GitHub で、organization のメイン ページに移動します。
-
組織名の下で、 [設定] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。
-
左のサイドバーで [アクション] をクリックしてから、 [ランナー] をクリックします。
-
"ランナー" の一覧で、構成するランナーをクリックします。
-
[ランナー グループ] ドロップダウンを選択します。
-
"ランナーをグループに移動" で、ランナーの移動先グループを選択します。
ランナー グループを削除する
ランナー グループを削除するには、まず、グループからすべてのランナーを移動するか削除する必要があります。
- ランナー グループが配置されている組織のメイン ページに移動します。
- [ 設定] をクリックします。
- 左サイドバーにある [アクション] をクリックし、 [ランナー グループ] をクリックします。
- グループの一覧で、削除するグループの右側にある をクリックします。
- グループを削除するには、 [グループの削除] をクリックします。
- 確認プロンプトを確認し、 [Remove this runner group](このランナー グループの削除) をクリックします。