セルフホストランナーとのラベルの利用

特定の種類のセルフホストランナーにジョブをまわすためのラベルの利用方法に関する情� �については、「ワークフロー内でのセルフホストランナーの利用」を参照してく� さい。

セルフホストランナーは、リポジトリ、Organization、 GitHub Enterprise Serverインスタンス上のEnterprise設定で見つかります。 セルフホストランナーを管理するには、セルフホストランナーが追� された� �所に応じて以下の権限が必要になります。

• ユーザリポジトリ: リポジトリのオーナーでなければなりません。

• Organization: Organizationのオーナーでなければなりません。

• Organizationのリポジトリ: Organizationのオーナーであるか、リポジトリへの管理アクセス権を持っていなければなりません。

• Enterprise: GitHub Enterpriseサイト管理者でなければなりません。

カスタ� ラベルの作成

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

   • Organizationもしくはリポジトリ内: メインページにアクセスして Settings（設定）をクリックしてく� さい。

   • Enterpriseレベルのランナーを使っている� �合:

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

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

   • In an organization or repository:

     1. In the left sidebar, click Actions.

   • Enterpriseレベルのランナーを使っている� �合:

     1. Enterpriseアカウントのサイドバーで、 Policies（ポリシー）をクリックしてく� さい。
     2. Under " Policies", click Actions.
     3. Self-hosted runners（セルフホストランナー）タブをクリックしてく� さい。

3. "Self-hosted runners（セルフホストランナー）"の下のランナーのリストを見つけてく� さい。

4. ランナーがグループ内にあるなら、そのランナーグループを見つけてをクリックし、ランナーのリストを表示させてく� さい。

5. 更新したいランナーを見つけて、をクリックしてラベル選択メニューを表示させてく� さい。 このメニューは、セルフホストランナーで利用できるすべてのカスタ� ラベルを表示します。 セルフホストランナーに割り当て済みのラベルには、隣にが表示されます。

6. "Filter labels（フィルターラベル）"フィールドで、新しいラベルの名前を入力し、Create new label（新しいラベルの作成）をクリックしてく� さい。

カスタ� ラベルが作成され、セルフホストランナーに割り当てられます。 カスタ� ラベルをセルフホストランナーから取り除くことはできますが、現在はラベルを手動で削除することはできません。 ランナーに割り当てられていない、未使用のラベルは、24時間以内に自動的に削除されます。

セルフホストランナーへのラベルの割り当て

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

   • Organizationもしくはリポジトリ内: メインページにアクセスして Settings（設定）をクリックしてく� さい。

   • Enterpriseレベルのランナーを使っている� �合:

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

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

   • In an organization or repository:

     1. In the left sidebar, click Actions.

   • Enterpriseレベルのランナーを使っている� �合:

     1. Enterpriseアカウントのサイドバーで、 Policies（ポリシー）をクリックしてく� さい。
     2. Under " Policies", click Actions.
     3. Self-hosted runners（セルフホストランナー）タブをクリックしてく� さい。

3. "Self-hosted runners（セルフホストランナー）"の下のランナーのリストを見つけてく� さい。

4. ランナーがグループ内にあるなら、そのランナーグループを見つけてをクリックし、ランナーのリストを表示させてく� さい。

5. 更新したいランナーを見つけて、をクリックしてラベル選択メニューを表示させてく� さい。 このメニューは、セルフホストランナーで利用できるすべてのカスタ� ラベルを表示します。 セルフホストランナーに割り当て済みのラベルには、隣にが表示されます。

6. ラベルをクリックして、セルフホストランナーに割り当ててく� さい。

カスタ� ラベルのセルフホストランナーからの削除

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

   • Organizationもしくはリポジトリ内: メインページにアクセスして Settings（設定）をクリックしてく� さい。

   • Enterpriseレベルのランナーを使っている� �合:

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

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

   • In an organization or repository:

     1. In the left sidebar, click Actions.

   • Enterpriseレベルのランナーを使っている� �合:

     1. Enterpriseアカウントのサイドバーで、 Policies（ポリシー）をクリックしてく� さい。
     2. Under " Policies", click Actions.
     3. Self-hosted runners（セルフホストランナー）タブをクリックしてく� さい。

3. "Self-hosted runners（セルフホストランナー）"の下のランナーのリストを見つけてく� さい。

4. ランナーがグループ内にあるなら、そのランナーグループを見つけてをクリックし、ランナーのリストを表示させてく� さい。

5. 更新したいランナーを見つけて、をクリックしてラベル選択メニューを表示させてく� さい。 このメニューは、セルフホストランナーで利用できるすべてのカスタ� ラベルを表示します。 セルフホストランナーに割り当て済みのラベルには、隣にが表示されます。

6. 割り当てられているラベルをクリックして、セルフホストランナーから削除してく� さい。 ランナーに割り当てられていない、未使用のラベルは、24時間以内に自動的に削除されます。

設定スクリプトを使ったラベルの作成と割り当て

セルフホストランナー上の設定スクリプトを使い、カスタ� ラベルの作成と割り当てを行えます。 たとえば、以下のコマンドはgpuというラベルをセルフホストランナーに割り当てます。

./config.sh --labels gpu

このラベルがま� 存在しなければ、作成されます。 このやり方で、x64あるいはlinuxといったデフォルトのラベルをランナーに割り当てることもできます。 デフォルトラベルが設定スクリプトで割り当てられた� �合、GitHub Actionsはそれらを指定されたとおりに受け付け、ランナーが実際にそのオペレーティングシステ� やアーキテクチャを使っているかは検証しません。

複数のラベルを割り当てるには、カンマ区切りが使えます。 例:

./config.sh --labels gpu,x64,linux