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

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

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

ここには以下の内容があります:

Did this doc help you?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

OR, learn how to contribute.

GitHub Actions の支払いを管理する GitHubは、macOSランナーのホストにMacStadiumを使用しています。

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

A self-hosted runner can be located in either your repository, organization, or enterprise account settings on GitHub. セルフホストランナーを管理するには、セルフホストランナーが追加された場所に応じて以下の権限が必要になります。

  • User repository: You must be the repository owner.

  • Organization: You must be an organization owner.

  • Organization repository: You must be an organization owner, or have admin access to the repository.

  • Enterprise account: You must be an enterprise owner.

カスタムラベルの作成

  1. Navigate to where your self-hosted runner is registered:

    • In an organization or repository: navigate to the main page and click Settings.
    • If using an enterprise account: navigate to your enterprise account by visiting https://github.com/enterprises/ENTERPRISE-NAME, replacing ENTERPRISE-NAME with your enterprise account's name. In the enterprise sidebar, Policies.
  2. Navigate to the GitHub Actions settings:

    • In an organization or repository: click Actions in the left sidebar.

      アクションの設定

    • If using an enterprise account: click Actions under " Policies".

  3. Locate the list of runners under "Self-hosted runners".

  4. If your runner is in a group, locate the runner group and click to view the list of runners.

    List runner group

  5. Locate the runner you want to update, and click to view the label selection menu. このメニューは、セルフホストランナーで利用できるすべてのカスタムラベルを表示します。 セルフホストランナーに割り当て済みのラベルには、隣にが表示されます。

    ランナーラベルの変更

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

    ランナーにラベルを追加

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

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

  1. Navigate to where your self-hosted runner is registered:

    • In an organization or repository: navigate to the main page and click Settings.
    • If using an enterprise account: navigate to your enterprise account by visiting https://github.com/enterprises/ENTERPRISE-NAME, replacing ENTERPRISE-NAME with your enterprise account's name. In the enterprise sidebar, Policies.
  2. Navigate to the GitHub Actions settings:

    • In an organization or repository: click Actions in the left sidebar.

      アクションの設定

    • If using an enterprise account: click Actions under " Policies".

  3. Locate the list of runners under "Self-hosted runners".

  4. If your runner is in a group, locate the runner group and click to view the list of runners.

    List runner group

  5. Locate the runner you want to update, and click to view the label selection menu. このメニューは、セルフホストランナーで利用できるすべてのカスタムラベルを表示します。 セルフホストランナーに割り当て済みのラベルには、隣にが表示されます。

    ランナーラベルの変更

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

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

  1. Navigate to where your self-hosted runner is registered:

    • In an organization or repository: navigate to the main page and click Settings.
    • If using an enterprise account: navigate to your enterprise account by visiting https://github.com/enterprises/ENTERPRISE-NAME, replacing ENTERPRISE-NAME with your enterprise account's name. In the enterprise sidebar, Policies.
  2. Navigate to the GitHub Actions settings:

    • In an organization or repository: click Actions in the left sidebar.

      アクションの設定

    • If using an enterprise account: click Actions under " Policies".

  3. Locate the list of runners under "Self-hosted runners".

  4. If your runner is in a group, locate the runner group and click to view the list of runners.

    List runner group

  5. Locate the runner you want to update, and click to view the label selection menu. このメニューは、セルフホストランナーで利用できるすべてのカスタムラベルを表示します。 セルフホストランナーに割り当て済みのラベルには、隣にが表示されます。

    ランナーラベルの変更

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

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

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

./config.sh --labels gpu

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

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

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

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

Did this doc help you?

Help us make these docs great!

All GitHub docs are open source. See something that's wrong or unclear? Submit a pull request.

Make a contribution

OR, learn how to contribute.