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

セルフホストランナーのグループについて

セルフホストランナーグループは、Organization レベルおよび Enterprise レベルでセルフホストランナーへのアクセスを制御するために使用されます。 Enterprise の管理者は、Enterprise 内のどの Organization がランナーグループにアクセスできるかを制御するアクセスポリシーを設定できます。 Organization の管理者は、Organization 内のどのリポジトリがランナーグループにアクセスできるかを制御するアクセスポリシーを設定できます。

Enterprise の管理者が Organization にランナーグループへのアクセスを許可すると、Organization の管理者は、Organization のセルフホストランナー設定にリストされたランナーグループを表示できます。 Organization の管理者は、追� の詳細なリポジトリアクセスポリシーを Enterprise ランナーグループに割り当てることができます。

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

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

すべての Organization には、単一のデフォルトのセルフホストランナーグループがあります。 Enterprise アカウント内の Organization は、追� のセルフホストグループを作成できます。 Organization の管理者は、個々のリポジトリにランナーグループへのアクセスを許可できます。 For information about how to create a self-hosted runner group with the REST API, see "Self-hosted runner groups."

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

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

1. your GitHub Enterprise Server instanceで、Organizationのメインページにアクセスしてく� さい。

2. Organization 名の下で、クリックします Settings.

   

3. 左のサイドバーで、Actionsをクリックしてく� さい。

4. Under "Self-hosted runners", click Add new, and then New group.

   

5. ランナーグループの名前を入力し、リポジトリアクセスのポリシーを割り当てます。

   You can configure a runner group to be accessible to a specific list of repositories, or to all repositories in the organization. By default, only private repositories can access runners in a runner group, but you can override this. This setting can't be overridden if configuring an organization's runner group that was shared by an enterprise.

   Warning

   セルフホストランナーは、プライベートリポジトリでのみ利用することをおすすめします。 これは、ワークフロー中でコードを実行するPull Requestを作成することによって、リポジトリのフォークが危険なコードをセルフホストランナーマシン上で実行できる可能性があるためです。

   詳しい情� �については「セルフホストランナーについて」を参照してく� さい。

   

6. [Save group] をクリックしてグループを作成し、ポリシーを適用します。

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

Enterprise は、セルフホストランナーをグループに追� して、アクセス管理を行うことができます。 Enterprise は、Enterprise アカウント内の特定の Organization がアクセスできるセルフホストランナーのグループを作成できます。 Organization の管理者は、追� の詳細なリポジトリアクセスポリシーを Enterprise ランナーグループに割り当てることができます。 For information about how to create a self-hosted runner group with the REST API, see the enterprise endpoints in the GitHub Actions REST API.

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

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

1. GitHub Enterprise Serverの右上で、プロフィール写真をクリックし、続いてEnterprise settings（Enterpriseの設定）をクリックしてく� さい。

2. Enterpriseアカウントのサイドバーで、 Policies（ポリシー）をクリックしてく� さい。

3. Under " Policies", click Actions.

4. Self-hosted runners（セルフホストランナー）タブをクリックしてく� さい。

5. [Add new] をクリックしてから、[New group] をクリックします。

   

6. ランナーグループの名前を入力し、Organization アクセスのポリシーを割り当てます。

   You can configure a runner group to be accessible to a specific list of organizations, or all organizations in the enterprise. By default, only private repositories can access runners in a runner group, but you can override this. This setting can't be overridden if configuring an organization's runner group that was shared by an enterprise.

   Warning

   セルフホストランナーは、プライベートリポジトリでのみ利用することをおすすめします。 これは、ワークフロー中でコードを実行するPull Requestを作成することによって、リポジトリのフォークが危険なコードをセルフホストランナーマシン上で実行できる可能性があるためです。

   詳しい情� �については「セルフホストランナーについて」を参照してく� さい。

   

7. [Save group] をクリックしてグループを作成し、ポリシーを適用します。

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

ランナーグループのアクセスポリシーを更新したり、ランナーグループの名前を変更したりすることができます。

1. 設定ページの"Self-hosted runners（セルフホストランナー）"のセクションで、設定したいランナーグループの隣のをクリックし、続いてEdit name and [organization|repository] access（名前と[Organization|リポジトリ]アクセスの編集）<クリックしてく� さい。

2. ポリシーオプションを修正するか、ランナーグループ名を変更してく� さい。

   Warning

   セルフホストランナーは、プライベートリポジトリでのみ利用することをおすすめします。 これは、ワークフロー中でコードを実行するPull Requestを作成することによって、リポジトリのフォークが危険なコードをセルフホストランナーマシン上で実行できる可能性があるためです。

   詳しい情� �については「セルフホストランナーについて」を参照してく� さい。

Automatically adding a self-hosted runner to a group

You can use the configuration script to automatically add a new self-hosted runner to a group. For example, this command registers a new self-hosted runner and uses the --runnergroup parameter to add it to a group named rg-runnergroup.

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

The command will fail if the runner group doesn't exist:

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

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

If you don't specify a runner group during the registration process, your new self-hosted runners are automatically assigned to the default group, and can then be moved to another group.

1. セルフホストランナーが登録されているところへアクセスしてく� さい:

   • In an organization: navigate to the main page and click Settings.

   • If using an enterprise-level runner:

     1. 任意のページの右上で をクリックします。
     2. 左のサイドバーでEnterprise overview（Enterpriseの概要）をクリックしてく� さい。
     3. In the enterprise sidebar, Policies.

2. GitHub Actions設定にアクセスしてく� さい:

   • In an organization: Click Actions in the left sidebar.
   • Enterpriseレベルのランナーを使っている� �合: " Policies（ポリシー）”の下のActionsをクリックしてく� さい。

3. In the "Self-hosted runners" section of the settings page, locate the current group of the runner you want to move and expand the list of group members.

4. セルフホストランナーの横にあるチェックボックスを選択し、[Move to group] をクリックして、利用可能な移動先を確認します。

5. 移動先のグループをクリックして、ランナーを移動します。

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

セルフホストランナーは、グループが削除されると自動的にデフォルトグループに戻ります。

1. In the "Self-hosted runners" section of the settings page, locate the group you want to delete, and click the button.

2. グループを削除するには、[Remove group] をクリックします。

3. 確認プロンプトを確認し、[Remove this runner group] をクリックします。