ノート: GitHub Actionsは、GitHub Enterprise Server 2.22で限定ベータとして利用可能でした。 ベータは終了しました。 GitHub Actionsは、GitHub Enterprise Server 3.0以降で一般に利用可能になりました。 詳しい情報については、GitHub Enterprise Server 3.0 のリリースノートを参照してください。
- GitHub Enterprise Server 3.0以降へのアップグレードに関する詳しい情報については「GitHub Enterprise Serverのアップグレード」を参照してください。
- アップグレード後のGitHub Actionsの設定に関する詳しい情報については、GitHub Enterprise Server 3.0のドキュメンテーションを参照してください。
ノート: GitHubホストランナーは、現在GitHub Enterprise Serverでサポートされていません。 GitHubパブリックロードマップで、計画されている将来のサポートに関する詳しい情報を見ることができます。
セルフホストランナーのグループについて
セルフホストランナーグループは、Organization レベルおよび Enterprise レベルでセルフホストランナーへのアクセスを制御するために使用されます。 Enterprise の管理者は、Enterprise 内のどの Organization がランナーグループにアクセスできるかを制御するアクセスポリシーを設定できます。 Organization の管理者は、Organization 内のどのリポジトリがランナーグループにアクセスできるかを制御するアクセスポリシーを設定できます。
Enterprise の管理者が Organization にランナーグループへのアクセスを許可すると、Organization の管理者は、Organization のセルフホストランナー設定にリストされたランナーグループを表示できます。 Organization の管理者は、追加の詳細なリポジトリアクセスポリシーを Enterprise ランナーグループに割り当てることができます。
新しいランナーが作成されると、それらは自動的にデフォルトグループに割り当てられます。 ランナーは一度に1つのグループにのみ参加できます。 ランナーはデフォルトグループから別のグループに移動できます。 詳しい情報については、「セルフホストランナーをグループに移動する」を参照してください。
Organization のセルフホストランナーグループを作成する
すべての Organization には、単一のデフォルトのセルフホストランナーグループがあります。 Enterprise アカウント内の Organization は、追加のセルフホストグループを作成できます。 Organization の管理者は、個々のリポジトリにランナーグループへのアクセスを許可できます。
セルフホストランナーは、作成時にデフォルトグループに自動的に割り当てられ、一度に 1 つのグループのメンバーになることができます。 ランナーはデフォルトグループから作成した任意のグループに移動できます。
グループを作成する場合、ランナーグループにアクセスできるリポジトリを定義するポリシーを選択する必要があります。
-
GitHub Enterprise Serverで、Organizationのメインページにアクセスしてください。
-
Organization 名の下で、クリックします Settings.
-
左のサイドバーで、Actionsをクリックしてください。
-
In the "Self-hosted runners" section, click Add new, and then New group.
-
ランナーグループの名前を入力し、リポジトリアクセスのポリシーを割り当てます。
You can configure a runner group to be accessible to a specific list of repositories, all private repositories, or all repositories in the organization.
Warning
セルフホストランナーは、プライベートリポジトリでのみ利用することをおすすめします。 これは、ワークフロー中でコードを実行するPull Requestを作成することによって、リポジトリのフォークが危険なコードをセルフホストランナーマシン上で実行できる可能性があるためです。
詳しい情報については「セルフホストランナーについて」を参照してください。
-
[Save group] をクリックしてグループを作成し、ポリシーを適用します。
Enterprise のセルフホストランナーグループを作成する
Enterprise は、セルフホストランナーをグループに追加して、アクセス管理を行うことができます。 Enterprise は、Enterprise アカウント内の特定の Organization がアクセスできるセルフホストランナーのグループを作成できます。 Organization の管理者は、追加の詳細なリポジトリアクセスポリシーを Enterprise ランナーグループに割り当てることができます。
セルフホストランナーは、作成時にデフォルトグループに自動的に割り当てられ、一度に 1 つのグループのメンバーになることができます。 登録処理中にランナーを特定のグループに割り当てることも、後でランナーをデフォルトグループからカスタムグループに移動することもできます。
グループを作成するときは、ランナーグループにアクセスできる Organization を定義するポリシーを選択する必要があります。
-
GitHub Enterprise Serverの右上で、プロフィール写真をクリックし、続いてEnterprise settings(Enterpriseの設定)をクリックしてください。
-
Enterpriseアカウントのサイドバーで、 Policies(ポリシー)をクリックしてください。
-
" Policies(ポリシー)"の下で、Actionsをクリックしてください。
-
Self-hosted runners(セルフホストランナー)タブをクリックしてください。
-
[Add new] をクリックしてから、[New group] をクリックします。
-
ランナーグループの名前を入力し、Organization アクセスのポリシーを割り当てます。
You can configure a runner group to be accessible to all organizations in the enterprise or choose specific organizations.
Warning
セルフホストランナーは、プライベートリポジトリでのみ利用することをおすすめします。 これは、ワークフロー中でコードを実行するPull Requestを作成することによって、リポジトリのフォークが危険なコードをセルフホストランナーマシン上で実行できる可能性があるためです。
詳しい情報については「セルフホストランナーについて」を参照してください。
-
[Save group] をクリックしてグループを作成し、ポリシーを適用します。
セルフホストランナーグループのアクセスポリシーを変更する
ランナーグループのアクセスポリシーを更新したり、ランナーグループの名前を変更したりすることができます。
-
設定ページの"Self-hosted runners(セルフホストランナー)"のセクションで、設定したいランナーグループの隣のをクリックし、続いてEdit name and [organization|repository] access(名前と[Organization|リポジトリ]アクセスの編集)<クリックしてください。
-
ポリシーオプションを修正するか、ランナーグループ名を変更してください。
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.
- 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.
- セルフホストランナーの横にあるチェックボックスを選択し、[Move to group] をクリックして、利用可能な移動先を確認します。
- 移動先のグループをクリックして、ランナーを移動します。
セルフホストランナーグループを削除する
セルフホストランナーは、グループが削除されると自動的にデフォルトグループに戻ります。
-
In the "Self-hosted runners" section of the settings page, locate the group you want to delete, and click the button.
-
グループを削除するには、[Remove group] をクリックします。
-
確認プロンプトを確認し、[Remove this runner group] をクリックします。