特定の種類のセルフホストランナーにジョブをまわすためのラベルの利用方法に関する情報については、「ワークフロー内でのセルフホストランナーの利用」を参照してください。
セルフホストランナーは、リポジトリ、Organization、GitHub上のEnterpriseアカウント設定で見つかります。 セルフホストランナーを管理するには、セルフホストランナーが追加された場所に応じて以下の権限が必要になります。
-
ユーザリポジトリ: リポジトリのオーナーでなければなりません。
-
Organization: Organizationのオーナーでなければなりません。
-
Organizationのリポジトリ: Organizationのオーナーであるか、リポジトリへの管理アクセス権を持っていなければなりません。
-
Enterpriseアカウント: Enterpriseのオーナーでなければなりません。
カスタムラベルの作成
-
セルフホストランナーが登録されているところへアクセスしてください:
-
Organizationもしくはリポジトリ内: メインページにアクセスして Settings(設定)をクリックしてください。
-
Enterpriseレベルのランナーを使っている場合:
-
GitHub.comの右上で、自分のプロフィール写真をクリックし、続いてYour enterprises(自分のEnterprise)をクリックしてください。
-
Enterpriseのリストで、表示したいEnterpriseをクリックしてください。
-
-
-
GitHub Actions設定にアクセスしてください:
-
In an organization or repository:
- 左のサイドバーで、 Actionsをクリックし、続いてRunners(ランナー)をクリックしてください。
-
Enterpriseレベルのランナーを使っている場合:
- Enterpriseアカウントのサイドバーで、 Policies(ポリシー)をクリックしてください。
- Under " Policies", click Actions.
- Runners(ランナー)タブをクリックしてください。
- Enterpriseアカウントのサイドバーで、 Policies(ポリシー)をクリックしてください。
-
-
In the list of runners, click the runner you'd like to configure.
-
In the "Labels" section, click .
-
In the "Find or create a label" field, type the name of your new label and click Create new label. カスタムラベルが作成され、セルフホストランナーに割り当てられます。 カスタムラベルをセルフホストランナーから取り除くことはできますが、現在はラベルを手動で削除することはできません。 ランナーに割り当てられていない、未使用のラベルは、24時間以内に自動的に削除されます。
セルフホストランナーへのラベルの割り当て
-
セルフホストランナーが登録されているところへアクセスしてください:
-
Organizationもしくはリポジトリ内: メインページにアクセスして Settings(設定)をクリックしてください。
-
Enterpriseレベルのランナーを使っている場合:
-
GitHub.comの右上で、自分のプロフィール写真をクリックし、続いてYour enterprises(自分のEnterprise)をクリックしてください。
-
Enterpriseのリストで、表示したいEnterpriseをクリックしてください。
-
-
-
GitHub Actions設定にアクセスしてください:
-
In an organization or repository:
- 左のサイドバーで、 Actionsをクリックし、続いてRunners(ランナー)をクリックしてください。
-
Enterpriseレベルのランナーを使っている場合:
- Enterpriseアカウントのサイドバーで、 Policies(ポリシー)をクリックしてください。
- Under " Policies", click Actions.
- Runners(ランナー)タブをクリックしてください。
- Enterpriseアカウントのサイドバーで、 Policies(ポリシー)をクリックしてください。
-
-
In the list of runners, click the runner you'd like to configure.
-
In the "Labels" section, click .
-
To assign a label to your self-hosted runner, in the "Find or create a label" field, click the label.
カスタムラベルのセルフホストランナーからの削除
-
セルフホストランナーが登録されているところへアクセスしてください:
-
Organizationもしくはリポジトリ内: メインページにアクセスして Settings(設定)をクリックしてください。
-
Enterpriseレベルのランナーを使っている場合:
-
GitHub.comの右上で、自分のプロフィール写真をクリックし、続いてYour enterprises(自分のEnterprise)をクリックしてください。
-
Enterpriseのリストで、表示したいEnterpriseをクリックしてください。
-
-
-
GitHub Actions設定にアクセスしてください:
-
In an organization or repository:
- 左のサイドバーで、 Actionsをクリックし、続いてRunners(ランナー)をクリックしてください。
-
Enterpriseレベルのランナーを使っている場合:
- Enterpriseアカウントのサイドバーで、 Policies(ポリシー)をクリックしてください。
- Under " Policies", click Actions.
- Runners(ランナー)タブをクリックしてください。
- Enterpriseアカウントのサイドバーで、 Policies(ポリシー)をクリックしてください。
-
-
In the list of runners, click the runner you'd like to configure.
-
In the "Labels" section, click .
-
In the "Find or create a label" field, assigned labels are marked with the icon. Click on a marked label to unassign it from your self-hosted runner.
設定スクリプトを使ったラベルの作成と割り当て
セルフホストランナー上の設定スクリプトを使い、カスタムラベルの作成と割り当てを行えます。 たとえば、以下のコマンドはgpu
というラベルをセルフホストランナーに割り当てます。
./config.sh --labels gpu
このラベルがまだ存在しなければ、作成されます。 このやり方で、x64
あるいはlinux
といったデフォルトのラベルをランナーに割り当てることもできます。 デフォルトラベルが設定スクリプトで割り当てられた場合、GitHub Actionsはそれらを指定されたとおりに受け付け、ランナーが実際にそのオペレーティングシステムやアーキテクチャを使っているかは検証しません。
複数のラベルを割り当てるには、カンマ区切りが使えます。 例:
./config.sh --labels gpu,x64,linux
ノート: 既存のランナーを置き換えた場合は、カスタムラベルがあるなら割り当てをしなおさなければなりません。