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

ラベルを使い、セルフホストランナーを特徴を基に整理できます。

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

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

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

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

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

  • Enterpriseアカウント: Enterpriseのオーナーでなければなりません。

カスタムラベルの作成

  1. セルフホストランナーが登録されているところへアクセスしてください:
    • Organizationもしくはリポジトリ内: メインページにアクセスして Settings(設定)をクリックしてください。
    • Enterpriseアカウントを使っている場合: https://github.com/enterprises/ENTERPRISE-NAMEにアクセスして、Enterpriseアカウントに移動してください。ENTERPRISE-NAMEは自分のEnterpriseアカウント名に置き換えてください。Enterpriseサイドバー内でPolicies(ポリシー)をクリックしてください。
  2. GitHub Actions設定にアクセスしてください:
    • Organizationもしくはリポジトリ内: 左のサイドバーでActionsをクリックし、続いてRunners(ランナー)をクリックしてください。
    • Enterpriseアカウントを使っている場合: " Policies(ポリシー)”の下のActionsをクリックし、続いてRunners(ランナー)タブをクリックしてください。
  3. "Runners(ランナー)"の下のランナーのリストを見つけてください。
  4. ランナーがグループ内にあるなら、そのランナーグループを見つけてをクリックし、ランナーのリストを表示させてください。 ランナーグループをリスト
  5. 更新したいランナーを見つけて、をクリックしてラベル選択メニューを表示させてください。 このメニューは、セルフホストランナーで利用できるすべてのカスタムラベルを表示します。 セルフホストランナーに割り当て済みのラベルには、隣にが表示されます。 ランナーラベルの変更
  6. "Filter labels(フィルターラベル)"フィールドで、新しいラベルの名前を入力し、Create new label(新しいラベルの作成)をクリックしてください。 ランナーにラベルを追加

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

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

  1. セルフホストランナーが登録されているところへアクセスしてください:
    • Organizationもしくはリポジトリ内: メインページにアクセスして Settings(設定)をクリックしてください。
    • Enterpriseアカウントを使っている場合: https://github.com/enterprises/ENTERPRISE-NAMEにアクセスして、Enterpriseアカウントに移動してください。ENTERPRISE-NAMEは自分のEnterpriseアカウント名に置き換えてください。Enterpriseサイドバー内でPolicies(ポリシー)をクリックしてください。
  2. GitHub Actions設定にアクセスしてください:
    • Organizationもしくはリポジトリ内: 左のサイドバーでActionsをクリックし、続いてRunners(ランナー)をクリックしてください。
    • Enterpriseアカウントを使っている場合: " Policies(ポリシー)”の下のActionsをクリックし、続いてRunners(ランナー)タブをクリックしてください。
  3. "Runners(ランナー)"の下のランナーのリストを見つけてください。
  4. ランナーがグループ内にあるなら、そのランナーグループを見つけてをクリックし、ランナーのリストを表示させてください。 ランナーグループをリスト
  5. 更新したいランナーを見つけて、をクリックしてラベル選択メニューを表示させてください。 このメニューは、セルフホストランナーで利用できるすべてのカスタムラベルを表示します。 セルフホストランナーに割り当て済みのラベルには、隣にが表示されます。 ランナーラベルの変更
  6. ラベルをクリックして、セルフホストランナーに割り当ててください。

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

  1. セルフホストランナーが登録されているところへアクセスしてください:
    • Organizationもしくはリポジトリ内: メインページにアクセスして Settings(設定)をクリックしてください。
    • Enterpriseアカウントを使っている場合: https://github.com/enterprises/ENTERPRISE-NAMEにアクセスして、Enterpriseアカウントに移動してください。ENTERPRISE-NAMEは自分のEnterpriseアカウント名に置き換えてください。Enterpriseサイドバー内でPolicies(ポリシー)をクリックしてください。
  2. GitHub Actions設定にアクセスしてください:
    • Organizationもしくはリポジトリ内: 左のサイドバーでActionsをクリックし、続いてRunners(ランナー)をクリックしてください。
    • Enterpriseアカウントを使っている場合: " Policies(ポリシー)”の下のActionsをクリックし、続いてRunners(ランナー)タブをクリックしてください。
  3. "Runners(ランナー)"の下のランナーのリストを見つけてください。
  4. ランナーがグループ内にあるなら、そのランナーグループを見つけてをクリックし、ランナーのリストを表示させてください。 ランナーグループをリスト
  5. 更新したいランナーを見つけて、をクリックしてラベル選択メニューを表示させてください。 このメニューは、セルフホストランナーで利用できるすべてのカスタムラベルを表示します。 セルフホストランナーに割り当て済みのラベルには、隣にが表示されます。 ランナーラベルの変更
  6. 割り当てられているラベルをクリックして、セルフホストランナーから削除してください。 ランナーに割り当てられていない、未使用のラベルは、24時間以内に自動的に削除されます。

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

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

./config.sh --labels gpu

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

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

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

ノート: 既存のランナーを置き換えた場合は、カスタムラベルがあるなら割り当てをしなおさなければなりません。

このドキュメントは役立ちましたか?プライバシーポリシー

これらのドキュメントを素晴らしいものにするのを手伝ってください!

GitHubのすべてのドキュメントはオープンソースです。間違っていたり、はっきりしないところがありましたか?Pull Requestをお送りください。

コントリビューションを行う

OR, コントリビューションの方法を学んでください。

問題がまだ解決していませんか?

GitHubコミュニティで質問するサポートへの連絡