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

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

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

ノート: GitHubホストランナーは、現在GitHub Enterprise Serverでサポートされていません。 GitHubパブリックロードマップで、計画されている将来のサポートに関する詳しい情報を見ることができます。

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

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

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

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

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

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

カスタムラベルの作成

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

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

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

      1. GitHub Enterprise Serverの右上で、プロフィール写真をクリックし、続いてEnterprise settings(Enterpriseの設定)をクリックしてください。 GitHub Enterprise Serverのプロフィール写真のドロップダウンメニュー内の"Enterprise settings"
  2. GitHub Actions設定にアクセスしてください:

    • In an organization or repository:

      1. In the left sidebar, click Actions.
      2. In the left sidebar, under "Actions", click Runners.
    • Enterpriseレベルのランナーを使っている場合:

      1. Enterpriseアカウントのサイドバーで、 Policies(ポリシー)をクリックしてください。 Enterpriseアカウントサイドバー内のポリシータブ
      2. Under " Policies", click Actions.
      3. Runners(ランナー)タブをクリックしてください。
  3. In the list of runners, click the runner you'd like to configure.

  4. In the "Labels" section, click .

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

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

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

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

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

      1. GitHub Enterprise Serverの右上で、プロフィール写真をクリックし、続いてEnterprise settings(Enterpriseの設定)をクリックしてください。 GitHub Enterprise Serverのプロフィール写真のドロップダウンメニュー内の"Enterprise settings"
  2. GitHub Actions設定にアクセスしてください:

    • In an organization or repository:

      1. In the left sidebar, click Actions.
      2. In the left sidebar, under "Actions", click Runners.
    • Enterpriseレベルのランナーを使っている場合:

      1. Enterpriseアカウントのサイドバーで、 Policies(ポリシー)をクリックしてください。 Enterpriseアカウントサイドバー内のポリシータブ
      2. Under " Policies", click Actions.
      3. Runners(ランナー)タブをクリックしてください。
  3. In the list of runners, click the runner you'd like to configure.

  4. In the "Labels" section, click .

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

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

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

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

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

      1. GitHub Enterprise Serverの右上で、プロフィール写真をクリックし、続いてEnterprise settings(Enterpriseの設定)をクリックしてください。 GitHub Enterprise Serverのプロフィール写真のドロップダウンメニュー内の"Enterprise settings"
  2. GitHub Actions設定にアクセスしてください:

    • In an organization or repository:

      1. In the left sidebar, click Actions.
      2. In the left sidebar, under "Actions", click Runners.
    • Enterpriseレベルのランナーを使っている場合:

      1. Enterpriseアカウントのサイドバーで、 Policies(ポリシー)をクリックしてください。 Enterpriseアカウントサイドバー内のポリシータブ
      2. Under " Policies", click Actions.
      3. Runners(ランナー)タブをクリックしてください。
  3. In the list of runners, click the runner you'd like to configure.

  4. In the "Labels" section, click .

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

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