Skip to main content

より大きなランナーを管理する

組織または企業の より大きなランナーを構成できます。

この機能を使用できるユーザーについて

Enterprise or organization owners can manage larger runners. Users with the "Manage organization runners and runner groups" permission can manage larger runners at the organization level.

GitHub でホストされる大規模ランナー are only available for organizations and enterprises using the GitHub Team or GitHub Enterprise Cloud plans.
Sign up for GitHub Actions

企業に より大きなランナー を追加する

エンタープライズ所有者は、 より大きなランナーを企業に追加し、それらを組織に割り当てることができます。 既定では、企業の より大きなランナー が作成されると、そのは、企業内のすべての組織がアクセスできる既定のランナー グループに追加されます。 すべての組織にランナーへのアクセス権が付与されますが、各組織のリポジトリにはアクセス権が付与されません。 各組織について、組織オーナーはランナーグループを構成して、エンタープライズランナーにアクセスできるリポジト リを指定する必要があります。 詳細については、「リポジトリがより大きなランナーにアクセスできるようにする」を参照してください。

使用可能なオプションのリストから、オペレーティング システムとハードウェア構成を選ぶことができます。 このランナーの新しいインスタンスが自動スケーリングによってデプロイされると、ここで定義したオペレーティング システムとハードウェア構成が使用されます。

新しいランナーが既定のグループに自動的に割り当てられるか、ランナー作成プロセス中にランナーを結合する必要があるグループを選ぶことができます。 また、ランナーを登録した後で、ランナーのグループ メンバーシップを変更できます。 詳しくは、「より大きなランナーへのアクセスの制御」をご覧ください。

  1. 企業ページに移動してください。 たとえば、GitHub.com の [Enterprise] ページから。

  2. ページの上部にある [ポリシーの] をクリックします。

  3. [ Policies] で、[Actions] をクリックします。

  4. [Runners](ランナー) タブをクリックします。

  5. [新しいランナー] をクリックしてから、 [ 新しい GitHubホステッド ランナー] をクリックします。

  6. 必要な詳細を入力して、新しいランナーを構成します。

    • 名前: 新しいランナーの名前を入力します。 識別しやすくするには、ハードウェアとオペレーティング システム (ubuntu-24.04-16core など) を示しておくのがよいでしょう。

    • プラットフォーム: 使用可能なオプションからプラットフォームを選択します。 プラットフォームを選択すると、特定のイメージを選択できるようになります。

      カスタム イメージをビルドする場合は、ランナー用に選択したプラットフォームが、ビルドするイメージのプラットフォームと一致している必要があります。 ランナーのプラットフォームは、次のいずれかになります。

      • Linux x64
      • Linux ARM64
      • Windows x64
    • イメージ: 使用可能なオプションからイメージを選択します。 画像を選択すると、特定のサイズを選択できるようになります。

      • GitHub 所有: GitHub によって管理されているイメージの場合は、このタブの下にあるイメージを選択します。
      • パートナー: パートナーが管理するイメージの場合は、このタブでイメージを選択します。たとえば、基本 Windows 11 デスクトップ、GPU 最適化、および arm64 のイメージは、このタブの下にあります。
      • 習慣: 組織または企業によって作成されたイメージの場合は、このタブの下にあるイメージを選択します。カスタム イメージは、ユーザー、組織、または企業が設定したイメージ構築ランナーでワークフローを実行することによって作成されます。 詳細については、「 カスタム イメージのインストール」を参照してください。
    • サイズ: 使用可能なオプションのリストからハードウェア構成を選択します。 使用可能なサイズは、前の手順で選択したイメージによって異なります。 GPU ランナーの場合は、[GPU 搭載] タブでサイズを選択します。

    • 最大同時実行数: いつでもアクティブにできるジョブの最大数を選択します。

    • ランナー グループ: ランナーがメンバーとなるグループを選びます。 需要に合わせてスケールアップまたはスケールダウンしながら、このグループによって、ランナーのインスタンスが複数ホストされます。 これらのステップを実行してください:

    • ネットワーク: より大きなランナー のインスタンスに静的 IP アドレス範囲を割り当てるかどうかを選びます。 静的IPアドレスを持つより大きなランナーを合計で10個まで使用できます。

    メモ

    より大きなランナー (larger runner) の名前によって、その機能が決まります。 たとえば、より大きなランナー のデフォルト設定に code scanning を使用するには、ランナーに code-scanning という名前を付ける必要があります。 code scanning と より大きなランナー (larger runner) の詳細については、「大きなランナーをデフォルトのセットアップ用に設定する」を参照してください。

  7. [ランナーの作成] をクリックします。

  8. Organization がより大きなランナーにアクセスできるようにするには、ランナーが割り当てられているランナー グループを使用できる Organization を指定します。 詳しくは、「より大きなランナーへのアクセスの制御」をご覧ください。

組織への より大きなランナー の追加

組織の所有者 および "組織ランナーとランナー グループの管理" アクセス許可を持つユーザーは 組織に より大きなランナー を追加し、それを使用できるリポジトリを制御できます。 組織用に新しいランナーを作成すると、既定では組織内のすべてのリポジトリがそのランナーにアクセスできるようになります。 ランナーを使用できるリポジトリを制限するには、特定のリポジトリにアクセスできるランナー グループに割り当てます。 詳しくは、「より大きなランナーへのアクセスをリポジトリに許可する」をご覧ください。

使用可能なオプションのリストから、オペレーティング システムとハードウェア構成を選ぶことができます。 このランナーの新しいインスタンスが自動スケーリングによってデプロイされると、ここで定義したオペレーティング システムとハードウェア構成が使用されます。

新しいランナーが既定のグループに自動的に割り当てられるか、ランナー作成プロセス中にランナーを結合する必要があるグループを選ぶことができます。 また、ランナーを登録した後で、ランナーのグループ メンバーシップを変更できます。 詳しくは、「より大きなランナーへのアクセスの制御」をご覧ください。

  1. GitHub で、organization のメイン ページに移動します。

  2. Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

    組織のプロファイルのタブのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で囲まれています。

  3. 左側のサイドバーで、 [Actions] をクリックしてから [Runners] をクリックします。

  4. [新しいランナー] をクリックしてから、 [ 新しい GitHubホステッド ランナー] をクリックします。

  5. 必要な詳細を入力して、新しいランナーを構成します。

    • 名前: 新しいランナーの名前を入力します。 識別しやすくするには、ハードウェアとオペレーティング システム (ubuntu-24.04-16core など) を示しておくのがよいでしょう。

    • プラットフォーム: 使用可能なオプションからプラットフォームを選択します。 プラットフォームを選択すると、特定のイメージを選択できるようになります。

      カスタム イメージをビルドする場合は、ランナー用に選択したプラットフォームが、ビルドするイメージのプラットフォームと一致している必要があります。 ランナーのプラットフォームは、次のいずれかになります。

      • Linux x64
      • Linux ARM64
      • Windows x64
    • イメージ: 使用可能なオプションからイメージを選択します。 画像を選択すると、特定のサイズを選択できるようになります。

      • GitHub 所有: GitHub によって管理されているイメージの場合は、このタブの下にあるイメージを選択します。
      • パートナー: パートナーが管理するイメージの場合は、このタブでイメージを選択します。たとえば、基本 Windows 11 デスクトップ、GPU 最適化、および arm64 のイメージは、このタブの下にあります。
      • 習慣: 組織または企業によって作成されたイメージの場合は、このタブの下にあるイメージを選択します。カスタム イメージは、ユーザー、組織、または企業が設定したイメージ構築ランナーでワークフローを実行することによって作成されます。 詳細については、「 カスタム イメージのインストール」を参照してください。
    • サイズ: 使用可能なオプションのリストからハードウェア構成を選択します。 使用可能なサイズは、前の手順で選択したイメージによって異なります。 GPU ランナーの場合は、[GPU 搭載] タブでサイズを選択します。

    • 最大同時実行数: いつでもアクティブにできるジョブの最大数を選択します。

    • ランナー グループ: ランナーがメンバーとなるグループを選びます。 需要に合わせてスケールアップまたはスケールダウンしながら、このグループによって、ランナーのインスタンスが複数ホストされます。 これらのステップを実行してください:

    • ネットワーク: より大きなランナー のインスタンスに静的 IP アドレス範囲を割り当てるかどうかを選びます。 静的IPアドレスを持つより大きなランナーを合計で10個まで使用できます。

    メモ

    より大きなランナー (larger runner) の名前によって、その機能が決まります。 たとえば、より大きなランナー のデフォルト設定に code scanning を使用するには、ランナーに code-scanning という名前を付ける必要があります。 code scanning と より大きなランナー (larger runner) の詳細については、「大きなランナーをデフォルトのセットアップ用に設定する」を参照してください。

  6. [ランナーの作成] をクリックします。

  7. リポジトリが より大きなランナーにアクセスできるようにするには、それを使用できるリポジトリの一覧に追加します。 詳細については、「リポジトリがより大きなランナーにアクセスできるようにする」を参照してください。

リポジトリが より大きなランナーにアクセスできるようにする

リポジトリには、ランナー グループを介して より大きなランナーへのアクセス権が付与されます。 エンタープライズ管理者は、エンタープライズ レベルのランナー グループへのアクセスを許可する組織を選択できます。また、組織の所有者と "Manage organization runners and runner groups" 権限を持つユーザーは、すべてのより大きなランナーに対するリポジトリ レベルのアクセスを制御できます。

組織の所有者は、組織内のリポジトリのエンタープライズ レベルのランナー グループを使用して構成することも、組織レベルのランナー グループを作成してアクセスを制御することもできます。 "組織ランナーとランナー グループの管理" を持つユーザーは、組織レベルのランナー グループのみを管理できます。 詳細については、 AUTOTITLE を参照してください。

  • **エンタープライズ レベルのランナー グループの場合:**既定では、Organization 内のリポジトリは Enterprise レベルのランナー グループにアクセスできません。 リポジトリに Enterprise ランナー グループへのアクセス権を付与するには、Organization の所有者が各 Enterprise ランナー グループを構成し、アクセスできるリポジトリを選ぶ必要があります。
  • **組織レベルのランナー グループの場合:**既定では、Organization 内のすべてのリポジトリに、Organization レベルのランナー グループへのアクセス権が付与されます。 アクセスできるリポジトリを制限するには、Organization の所有者と "Organization ランナーとランナー グループの管理" アクセス許可を持つユーザーが Organization ランナー グループを構成し、アクセスできるリポジトリを選ぶ必要があります。

リポジトリが より大きなランナーにアクセスできたら、 より大きなランナーをワークフロー ファイルに追加できます。 詳しくは、「より大きなランナーでジョブを実行する」をご覧ください。

  1. ランナー グループが配置されている組織のメイン ページに移動します。
  2. [Settings] をクリックします。
  3. 左側のサイドバーで、 [Actions] をクリックしてから [Runner groups] をクリックします。
  4. ページのいずれかの一覧からランナー グループを選びます。 組織レベルのランナー グループはページの上部に、エンタープライズ レベルのランナー グループは [エンタープライズで共有] の下に表示されます。
  5. ランナー グループ ページの [リポジトリ アクセス] で、 [すべてのリポジトリ] または [選択したリポジトリ] を選びます。 特定のリポジトリへのアクセス権を付与する場合は、[ ] をクリックし、アクセス権を付与するリポジトリを一覧から選択します。

警告

固定 IP 範囲を使っている場合、プライベート リポジトリには より大きなランナー のみを使うことをお勧めします。 ワークフロー内でコードを実行する pull request を作成することで、リポジトリのフォークによって、より大きなランナー 上で危険なコードが実行される可能性があります。 詳しくは、「より大きなランナーへのアクセスの制御」をご覧ください。

ランナー グループを介してのみランナーをターゲットにするようにワークフローを要求する場合は、組織レベルまたはエンタープライズ レベルで標準の GitHubホストランナーを無効にすることができます。 「組織のGitHub Actionsの無効化または制限」と「企業でGitHub Actionsのポリシーを適用する」を参照してください。

より大きなランナー の名前を変更する

メモ

より大きなランナー (larger runner) の名前によって、その機能が決まります。 たとえば、より大きなランナー のデフォルト設定に code scanning を使用するには、ランナーに code-scanning という名前を付ける必要があります。 code scanning と より大きなランナー (larger runner) の詳細については、「大きなランナーをデフォルトのセットアップ用に設定する」を参照してください。

お使いのより大きなランナーの名前を編集できます。

組織ランナーの名前を変更する

  1. GitHub で、organization のメイン ページに移動します。

  2. Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

    組織のプロファイルのタブのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で囲まれています。

  3. 左側のサイドバーで、 [Actions] をクリックしてから [Runners] をクリックします。

  4. ランナーの一覧で、編集するランナーを選びます。

  5. [名前] のテキスト フィールドにランナーの新しい名前を入力します。

  6. [保存] をクリックします。

エンタープライズ ランナーの名前を変更する

  1. 企業ページに移動してください。 たとえば、GitHub.com の [Enterprise] ページから。
  2. ページの上部にある [ポリシーの] をクリックします。
  3. [ Policies] で、[Actions] をクリックします。
  4. [Runners](ランナー) タブをクリックします。
  5. ランナーの一覧で、編集するランナーを選びます。
  6. [名前] のテキスト フィールドにランナーの新しい名前を入力します。
  7. [保存] をクリックします。

より大きなランナー のサイズを変更する

より大きなランナーのサイズを編集できます。

組織ランナーのサイズを変更する

  1. GitHub で、organization のメイン ページに移動します。

  2. Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

    組織のプロファイルのタブのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で囲まれています。

  3. 左側のサイドバーで、 [Actions] をクリックしてから [Runners] をクリックします。

  4. ランナーの一覧で、編集するランナーを選びます。

  5. [Size] で使用可能なオプションの一覧からランナーの新しいサイズを選択します。 使用可能なサイズは、ランナーにインストールされているイメージによって異なります。

  6. [保存] をクリックします。

エンタープライズ ランナーのサイズを変更する

  1. 企業ページに移動してください。 たとえば、GitHub.com の [Enterprise] ページから。
  2. ページの上部にある [ポリシーの] をクリックします。
  3. [ Policies] で、[Actions] をクリックします。
  4. [Runners](ランナー) タブをクリックします。
  5. ランナーの一覧で、編集するランナーを選びます。
  6. [Size] で使用可能なオプションの一覧からランナーの新しいサイズを選択します。 使用可能なサイズは、ランナーにインストールされているイメージによって異なります。
  7. [保存] をクリックします。

の画像を変更する より大きなランナー

より大きなランナー が提供するイメージを使用している場合は、GitHub のイメージを編集できます。 マネージド イメージの一覧については、 GitHub Actions Runner Images リポジトリを参照してください。

組織ランナーのイメージを変更する

  1. GitHub で、organization のメイン ページに移動します。

  2. Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

    組織のプロファイルのタブのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で囲まれています。

  3. 左側のサイドバーで、 [Actions] をクリックしてから [Runners] をクリックします。

  4. ランナーの一覧で、編集するランナーを選びます。

  5. [Image] の使用できるオプションの一覧からランナーの新しいイメージを選びます。 使用できるイメージは、GitHub が所有するイメージに限定されます。

  6. [保存] をクリックします。

企業ランナーのイメージを変更する

  1. 企業ページに移動してください。 たとえば、GitHub.com の [Enterprise] ページから。
  2. ページの上部にある [ポリシーの] をクリックします。
  3. [ Policies] で、[Actions] をクリックします。
  4. [Runners](ランナー) タブをクリックします。
  5. ランナーの一覧で、編集するランナーを選びます。
  6. [Image] の使用できるオプションの一覧からランナーの新しいイメージを選びます。 使用できるイメージは、GitHub が所有するイメージに限定されます。
  7. [保存] をクリックします。

より大きなランナー のオートスケーリングの設定

特定のランナー セットに対して同時に実行できるジョブの最大数を制御できます。 このフィールドを高い値に設定すると、並列処理が原因でワークフローがブロックされるのを防ぐことができます。

組織ランナーの自動スケーリングを構成する

  1. GitHub で、organization のメイン ページに移動します。

  2. Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

    組織のプロファイルのタブのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で囲まれています。

  3. 左側のサイドバーで、 [Actions] をクリックしてから [Runners] をクリックします。

  4. ランナーの一覧で、編集するランナーを選びます。

  5. [容量] セクションの [最大コンカレンシー] に、同時に実行できるようにするジョブの最大数を入力します。

  6. [保存] をクリックします。

エンタープライズ ランナーの自動スケーリングを構成する

  1. 企業ページに移動してください。 たとえば、GitHub.com の [Enterprise] ページから。
  2. ページの上部にある [ポリシーの] をクリックします。
  3. [ Policies] で、[Actions] をクリックします。
  4. [Runners](ランナー) タブをクリックします。
  5. ランナーの一覧で、編集するランナーを選びます。
  6. [容量] セクションの [最大コンカレンシー] に、同時に実行できるようにするジョブの最大数を入力します。
  7. [保存] をクリックします。

より大きなランナーの静的 IP アドレスの作成

メモ

  • 静的 IP アドレスを使用するには、組織で GitHub Enterprise Cloudを使用する必要があります。 GitHub Enterprise Cloud を無料で試す方法の詳細については、「GitHub Enterprise Cloud の試用版を設定する」を参照してください。
  • macOS より大きなランナーは静的 IP アドレスをサポートしていません。

より大きなランナーの静的 IP アドレスを有効にすることができます。 これを行うと、 より大きなランナーには静的 IP アドレス範囲が割り当てられます。 割り当てられた範囲内のすべての IP アドレスを使用できます。 既定では、アカウントの静的 IP アドレス範囲を使用して最大 10 個の より大きなランナー プールを構成できます。 静的 IP アドレス範囲を持つ 10 を超える大きなランナー プールを使用する場合は、 GitHub サポート ポータルにお問い合わせください。

作成する各 より大きなランナー は、1 台のコンピューターではありません。 ランナーの作成時に設定した最大コンカレンシーまで、同時実行ジョブを処理するために自動的にスケールアウトされるランナーのプールです。 プール内のすべてのジョブは、同じ静的 IP アドレス範囲を共有します。 つまり、1 つの静的 IP 範囲を持つ 1 つの より大きなランナー で、追加のランナーを必要とせずに、同時に実行される多くのジョブを処理できます。

割り当てられた範囲で使用可能な IP アドレスの数によって、同時実行ジョブの数は制限されません。 ランナー プール内にはロード バランサーがあり、割り当てられた範囲の IP アドレスを高度に再利用することができます。 これにより、各マシンに静的 IP アドレスが割り当てられていても、大規模なワークフローを同時に実行できます。

組織ランナー用に静的 IP アドレスを作成する

  1. GitHub で、organization のメイン ページに移動します。

  2. Organization 名の下で、[ Settings] をクリックします。 [設定] タブが表示されない場合は、 [] ドロップダウン メニューを選び、 [設定] をクリックします。

    組織のプロファイルのタブのスクリーンショット。 [設定] タブが濃いオレンジ色の枠線で囲まれています。

  3. 左側のサイドバーで、 [Actions] をクリックしてから [Runners] をクリックします。

  4. ランナーの一覧で、編集するランナーを選びます。

  5. ランナーに静的 IP アドレスを割り当てるには、[ネットワーク] の下の [このランナーに一意の静的パブリック IP アドレス範囲を割り当てる] をオンにします。

  6. [保存] をクリックします。

エンタープライズ ランナー用に静的 IP アドレスを作成する

  1. 企業ページに移動してください。 たとえば、GitHub.com の [Enterprise] ページから。
  2. ページの上部にある [ポリシーの] をクリックします。
  3. [ Policies] で、[Actions] をクリックします。
  4. [Runners](ランナー) タブをクリックします。
  5. ランナーの一覧で、編集するランナーを選びます。
  6. ランナーに静的 IP アドレスを割り当てるには、[ネットワーク] の下の [このランナーに一意の静的パブリック IP アドレス範囲を割り当てる] をオンにします。
  7. [保存] をクリックします。