Skip to main content
ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。

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

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

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

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

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

カスタムラベルの作成

  1. Navigate to the main page of the organization or repository where your self-hosted runner group is registered.

  2. Click Settings.

  3. In the left sidebar, click Actions, then click Runners.

  4. In the list of runners, click the runner you'd like to configure.

  5. In the "Labels" section, click .

  6. In the "Find or create a label" field, type the name of your new label and click Create new label. カスタムラベルが作成され、セルフホストランナーに割り当てられます。 カスタムラベルをセルフホストランナーから取り除くことはできますが、現在はラベルを手動で削除することはできません。 ランナーに割り当てられていない、未使用のラベルは、24時間以内に自動的に削除されます。

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

  1. Navigate to the main page of the organization or repository where your self-hosted runner group is registered.

  2. Click Settings.

  3. In the left sidebar, click Actions, then click Runners.

  4. In the list of runners, click the runner you'd like to configure.

  5. In the "Labels" section, click .

  6. To assign a label to your self-hosted runner, in the "Find or create a label" field, click the label.

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

  1. Navigate to the main page of the organization or repository where your self-hosted runner group is registered.

  2. Click Settings.

  3. In the left sidebar, click Actions, then click Runners.

  4. In the list of runners, click the runner you'd like to configure.

  5. In the "Labels" section, click .

  6. 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

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