グループを使用してセルフホストランナーへのアクセスを管理する

ランナーグループについて

ランナーグループは、Organization レベルと Enterprise レベルのランナーへのアクセスを制御するために使用されます。 Enterprise の所有者はアクセスポリシーを設定して、Enterprise 内のどの Organization がランナーグループにアクセスできるかを制御できます。 Organization の所有者はアクセスポリシーを設定して、Organization 内のどのリポジトリがランナーグループにアクセスできるかを制御できます。

Enterprise の所有者がランナーグループにアクセス権を付与する場合、Organization の所有者には、Organization のランナー設定に一覧表示されているランナーグループが表示されます。その後、Organization の所有者は、リポジトリの詳細な追加アクセスポリシーを、Enterprise ランナーグループに割り当てることができます。

新しいランナーが作成されると、それらは自動的にデフォルトグループに割り当てられます。ランナーは一度に1つのグループにのみ参加できます。ランナーはデフォルトグループから別のグループに移動できます。詳しくは、「ランナーをグループに移動する」をご覧ください。

Organization のセルフホストランナーグループを作成する

すべての Organization には、単一の既定のランナーグループがあります。 Enterprise アカウント内の Organization を使うと、追加のグループを作成できます。 Organization の管理者は、個々のリポジトリにランナーグループへのアクセスを許可できます。 REST API を使ってランナーグループを作成する方法について詳しくは、「セルフホストランナーグループ」をご覧ください。

ランナーは、作成時に既定のグループに自動的に割り当てられます。一度に 1 つのグループでのみメンバーになることができます。ランナーはデフォルトグループから作成した任意のグループに移動できます。

グループを作成するときは、ランナーグループにアクセスできるリポジトリが定義されているポリシーを選ぶ必要があります。

your enterprise で、Organization のメインページへ移動します。 1. Organization 名の下で、 [設定] をクリックします。 1. 左側のサイドバーで、 [アクション] をクリックします。
左側のサイドバーの [アクション] で、 [ランナーグループ] をクリックします。
"ランナーグループ" セクションで、 [新しいランナーグループ] をクリックします。
ランナーグループの名前を入力します。
リポジトリアクセスのポリシーを割り当てます。

リポジトリの特定のリストまたは組織内のすべてのリポジトリにアクセス可能なランナーグループを設定できます。 1. [グループの作成] をクリックし、グループを作成してポリシーを適用します。

Enterprise のセルフホストランナーグループを作成する

Enterprise を使うと、ランナーがグループに追加されて、アクセス管理を行うことができます。 Enterprise は、Enterprises アカウント内の特定の Organization 。その後、Organization の所有者は、Enterprise ランナーグループに対し、追加の詳細なリポジトリアクセスポリシーを割り当てることができます。 REST API を使ってランナーグループを作成する方法については、GitHub Actions REST API の Enterprise エンドポイントをご覧ください。

ランナーは、作成時に既定のグループに自動的に割り当てられます。一度に 1 つのグループでのみメンバーになることができます。登録処理中にランナーを特定のグループに割り当てることも、後でランナーをデフォルトグループからカスタムグループに移動することもできます。

グループを作成するときは、ランナーグループにアクセスできる Organization を定義するポリシーを選択する必要があります。

GitHub AE の右上で、ご自分のプロファイル写真をクリックしてから、 [Enterprise 設定] をクリックします。 1. Enterprise サイドバーで、 [ポリシー] をクリックします。 1. [ ポリシー] で、 [アクション] をクリックします。 1. [ランナーグループ] タブをクリックします。
[New runner group](新しいランナーグループ) をクリックします。
[グループ名] に、ランナーグループの名前を入力します。
組織アクセスのポリシーを選択するには、 [組織のアクセス] ドロップダウンを選択し、[ポリシー] をクリックします。組織の特定のリストまたはエンタープライズ内のすべての組織にアクセス可能なランナーグループを設定できます。
[グループの保存] をクリックしてグループを作成し、ポリシーを適用します。

セルフホストランナーグループのアクセスポリシーを変更する

Enterprise のランナーグループの場合、Enterprise 内のどの Organization がランナーグループにアクセスできるかを変更できます。 Organization のランナーグループの場合、Organization 内のどのリポジトリがランナーグループにアクセスできるかを変更できます。

ランナーグループにアクセスできる組織またはリポジトリを変更する

ランナーグループが配置されている場所に移動します。
- Organization 内: メインページに移動して、 [設定] をクリックします。
- Enterprise レベルのグループを使用している場合:
  1. GitHub AE の右上で、ご自分のプロファイル写真をクリックしてから、 [Enterprise 設定] をクリックします。
[ランナーグループ] 設定に移動します:
- Organization 内:
  1. 左側のサイドバーで、 [アクション] をクリックします。
  2. 左側のサイドバーの [アクション] で、 [ランナーグループ] をクリックします。
- Enterprise レベルのグループを使用している場合:
  1. Enterprise サイドバーで、 [ポリシー] をクリックします。 1. [ ポリシー] で、 [アクション] をクリックします。 1. [ランナーグループ] タブをクリックします。 1. グループのリストで、構成するランナーグループをクリックします。
エンタープライズ内のランナーグループの場合、 [組織のアクセス] で、ランナーグループにアクセスできる組織を変更します。組織内のランナーグループの場合、 [リポジトリアクセス] で、ランナーグループにアクセスできるリポジトリを変更します。

ランナーグループの名前を変更する

ランナーグループが配置されている場所に移動します。
- Organization 内: メインページに移動して、 [設定] をクリックします。
- Enterprise レベルのグループを使用している場合:
  1. GitHub AE の右上で、ご自分のプロファイル写真をクリックしてから、 [Enterprise 設定] をクリックします。
[ランナーグループ] 設定に移動します:
- Organization 内:
  1. 左側のサイドバーで、 [アクション] をクリックします。
  2. 左側のサイドバーの [アクション] で、 [ランナーグループ] をクリックします。
- Enterprise レベルのグループを使用している場合:
  1. Enterprise サイドバーで、 [ポリシー] をクリックします。 1. [ ポリシー] で、 [アクション] をクリックします。 1. [ランナーグループ] タブをクリックします。 1. グループのリストで、構成するランナーグループをクリックします。
ランナーグループ名を変更します。

セルフホストランナーをグループに自動的に追加する

構成スクリプトを使うと、新しいランナーをグループに自動的に追加できます。たとえば、このコマンドを実行すると、新しいランナーが登録されて、--runnergroup パラメーターを使って rg-runnergroup という名前のグループに追加されます。

./config.sh --url $org_or_enterprise_url --token $token --runnergroup rg-runnergroup

ランナーグループが存在しない場合、コマンドは失敗します。

Could not find any self-hosted runner group named "rg-runnergroup".

セルフホストランナーをグループに移動する

登録プロセス中にランナーグループを指定しない場合、新しいランナーは、自動的に既定のグループに割り当てられ、その後別のグループへの移動が可能となります。

ランナーが登録されている場所に移動します。
- Organization 内: メインページに移動して、 [設定] をクリックします。
- Enterprise レベルのランナーを使用している場合:
  1. GitHub AE の右上で、ご自分のプロファイル写真をクリックしてから、 [Enterprise 設定] をクリックします。
GitHub Actions設定にアクセスしてください:
- Organization 内:
  1. 左側のサイドバーで、 [アクション] をクリックします。
  2. 左側のサイドバーの [アクション] で、 [ランナー] をクリックします。
- Enterprise レベルのランナーを使用している場合:
  1. Enterprise サイドバーで、 [ポリシー] をクリックします。 1. [ ポリシー] で、 [アクション] をクリックします。 1. [Runners](ランナー) タブをクリックします。
"ランナー" の一覧で、構成するランナーをクリックします。
[ランナーグループ] ドロップダウンを選択します。
"ランナーをグループに移動" で、ランナーの移動先グループを選択します。

セルフホストランナーグループを削除する

ランナーは、そのグループが削除されると自動的に既定のグループに戻ります。

ランナーグループが配置されている場所に移動します。
- Organization 内: メインページに移動して、 [設定] をクリックします。
- Enterprise レベルのグループを使用している場合:
  1. GitHub AE の右上で、ご自分のプロファイル写真をクリックしてから、 [Enterprise 設定] をクリックします。
[ランナーグループ] 設定に移動します:
- Organization 内:
  1. 左側のサイドバーで、 [アクション] をクリックします。
  2. 左側のサイドバーの [アクション] で、 [ランナーグループ] をクリックします。
- Enterprise レベルのグループを使用している場合:
  1. Enterprise サイドバーで、 [ポリシー] をクリックします。 1. [ ポリシー] で、 [アクション] をクリックします。 1. [ランナーグループ] タブをクリックします。
グループの一覧で、削除するグループの右側にあるをクリックします。
グループを削除するには、 [グループの削除] をクリックします。
確認プロンプトを確認し、 [Remove this runner group](このランナーグループの削除) をクリックします。このグループのすべてのランナーは、既定のグループに自動的に移動します。ここでは、このグループに割り当てられたアクセス許可を継承します。

グループを使用してセルフホストランナーへのアクセスを管理する

In this article

ランナー グループについて