ノート: GitHubホストランナーは、現在GitHub Enterprise Serverでサポートされていません。 GitHubパブリックロードマップで、計画されている将来のサポートに関する詳しい情� �を見ることができます。
特定の種類のセルフホストランナーにジョブをまわすためのラベルの利用方法に関する情� �については、「ワークフロー内でのセルフホストランナーの利用」を参照してく� さい。
セルフホストランナーは、リポジトリ、Organization、 your GitHub Enterprise Server instance上のEnterprise設定で見つかります。 セルフホストランナーを管理するには、セルフホストランナーが追� された� �所に応じて以下の権限が必要になります。
-
ユーザリポジトリ: リポジトリのオーナーでなければなりません。
-
Organization: Organizationのオーナーでなければなりません。
-
Organizationのリポジトリ: Organizationのオーナーであるか、リポジトリへの管理アクセス権を持っていなければなりません。
-
Enterprise: GitHub Enterpriseサイト管理者でなければなりません。
カスタ� ラベルの作成
-
セルフホストランナーが登録されているところへアクセスしてく� さい:
- Organizationもしくはリポジトリ内: メインページにアクセスして Settings(設定)をクリックしてく� さい。
- Enterpriseレベルのランナーを使っている� �合:
- 任意のページの右上で をクリックします。
- 左のサイドバーでEnterprise overview(Enterpriseの概要)をクリックしてく� さい。
- In the enterprise sidebar, click Policies.
-
GitHub Actions設定にアクセスしてく� さい:
- In an organization or repository: Click Actions in the left sidebar.
- If using an enterprise-level runner: Click Actions under " Policies".
-
"Self-hosted runners(セルフホストランナー)"の下のランナーのリストを見つけてく� さい。
-
ランナーがグループ内にあるなら、そのランナーグループを見つけてをクリックし、ランナーのリストを表示させてく� さい。
-
更新したいランナーを見つけて、をクリックしてラベル選択メニューを表示させてく� さい。 このメニューは、セルフホストランナーで利用できるすべてのカスタ� ラベルを表示します。 セルフホストランナーに割り当て済みのラベルには、隣にが表示されます。
-
"Filter labels(フィルターラベル)"フィールドで、新しいラベルの名前を入力し、Create new label(新しいラベルの作成)をクリックしてく� さい。
カスタ� ラベルが作成され、セルフホストランナーに割り当てられます。 カスタ� ラベルをセルフホストランナーから取り除くことはできますが、現在はラベルを手動で削除することはできません。 ランナーに割り当てられていない、未使用のラベルは、24時間以内に自動的に削除されます。
セルフホストランナーへのラベルの割り当て
-
セルフホストランナーが登録されているところへアクセスしてく� さい:
- Organizationもしくはリポジトリ内: メインページにアクセスして Settings(設定)をクリックしてく� さい。
- Enterpriseレベルのランナーを使っている� �合:
- 任意のページの右上で をクリックします。
- 左のサイドバーでEnterprise overview(Enterpriseの概要)をクリックしてく� さい。
- In the enterprise sidebar, click Policies.
-
GitHub Actions設定にアクセスしてく� さい:
- In an organization or repository: Click Actions in the left sidebar.
- If using an enterprise-level runner: Click Actions under " Policies".
-
"Self-hosted runners(セルフホストランナー)"の下のランナーのリストを見つけてく� さい。
-
ランナーがグループ内にあるなら、そのランナーグループを見つけてをクリックし、ランナーのリストを表示させてく� さい。
-
更新したいランナーを見つけて、をクリックしてラベル選択メニューを表示させてく� さい。 このメニューは、セルフホストランナーで利用できるすべてのカスタ� ラベルを表示します。 セルフホストランナーに割り当て済みのラベルには、隣にが表示されます。
-
ラベルをクリックして、セルフホストランナーに割り当ててく� さい。
カスタ� ラベルのセルフホストランナーからの削除
-
セルフホストランナーが登録されているところへアクセスしてく� さい:
- Organizationもしくはリポジトリ内: メインページにアクセスして Settings(設定)をクリックしてく� さい。
- Enterpriseレベルのランナーを使っている� �合:
- 任意のページの右上で をクリックします。
- 左のサイドバーでEnterprise overview(Enterpriseの概要)をクリックしてく� さい。
- In the enterprise sidebar, click Policies.
-
GitHub Actions設定にアクセスしてく� さい:
- In an organization or repository: Click Actions in the left sidebar.
- If using an enterprise-level runner: Click Actions under " Policies".
-
"Self-hosted runners(セルフホストランナー)"の下のランナーのリストを見つけてく� さい。
-
ランナーがグループ内にあるなら、そのランナーグループを見つけてをクリックし、ランナーのリストを表示させてく� さい。
-
更新したいランナーを見つけて、をクリックしてラベル選択メニューを表示させてく� さい。 このメニューは、セルフホストランナーで利用できるすべてのカスタ� ラベルを表示します。 セルフホストランナーに割り当て済みのラベルには、隣にが表示されます。
-
割り当てられているラベルをクリックして、セルフホストランナーから削除してく� さい。 ランナーに割り当てられていない、未使用のラベルは、24時間以内に自動的に削除されます。
設定スクリプトを使ったラベルの作成と割り当て
セルフホストランナー上の設定スクリプトを使い、カスタ� ラベルの作成と割り当てを行えます。 たとえば、以下のコマンドはgpu
というラベルをセルフホストランナーに割り当てます。
./config.sh --labels gpu
このラベルがま� 存在しなければ、作成されます。 このやり方で、x64
あるいはlinux
といったデフォルトのラベルをランナーに割り当てることもできます。 デフォルトラベルが設定スクリプトで割り当てられた� �合、GitHub Actionsはそれらを指定されたとおりに受け付け、ランナーが実際にそのオペレーティングシステ� やアーキテクチャを使っているかは検証しません。
複数のラベルを割り当てるには、カンマ区切りが使えます。 例:
./config.sh --labels gpu,x64,linux
ノート: 既存のランナーを置き換えた� �合は、カスタ� ラベルがあるなら割り当てをしなおさなければなりません。