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

組織またはエンタープライズ用により大きなランナーを構成できます。

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

より大きなランナー は、GitHub Team または GitHub Enterprise Cloud プランを使っている組織とエンタープライズのみが使用できます。

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.

この記事の内容

Note

  • この記事の情報と手順は、Linux または Windows オペレーティング システムを搭載した より大きなランナー にのみ適用されます。

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

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

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

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

  1. GitHub の右上隅にあるプロフィール写真をクリックします。

  2. ご自分の環境に応じて、[Your enterprise] または [Your enterprises] をクリックし、表示するエンタープライズをクリックします。

  3. ページの左側にある Enterprise アカウントのサイドバーで、 [ポリシー] をクリックします。

  4. 「 ポリシー」で、[アクション] をクリックします。

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

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

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

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

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

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

      • GitHub 所有: GitHub によって管理されているイメージの場合は、このタブの下にあるイメージを選択します。
      • パートナー: パートナーが管理するイメージの場合は、このタブでイメージを選択します。Windows 11 デスクトップおよび GPU 最適化イメージは、このタブの下にあります。

    • サイズ: 使用可能なオプションのリストからハードウェア構成を選択します。 使用可能なサイズは、前の手順で選択したイメージによって異なります。 GPU ランナーの場合は、[GPU 搭載] タブでサイズを選択します。

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

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

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

    Note

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

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

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

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

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

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

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

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

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

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

  3. 左のサイドバーで [アクション] をクリックしてから、 [ランナー] をクリックします。

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

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

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

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

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

      • GitHub 所有: GitHub によって管理されているイメージの場合は、このタブの下にあるイメージを選択します。
      • パートナー: パートナーが管理するイメージの場合は、このタブでイメージを選択します。Windows 11 デスクトップおよび GPU 最適化イメージは、このタブの下にあります。

    • サイズ: 使用可能なオプションのリストからハードウェア構成を選択します。 使用可能なサイズは、前の手順で選択したイメージによって異なります。 GPU ランナーの場合は、[GPU 搭載] タブでサイズを選択します。

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

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

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

    Note

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

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

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

より大きなランナーへのアクセスをリポジトリに許可する

リポジトリには、ランナー グループを介してより大きなランナーへのアクセス権が付与されます。 Enterprise 管理者は、Enterprise レベルのランナー グループへのアクセス権を付与する Organization を選択でき、Organization の所有者と "Organization ランナーとランナー グループの管理" アクセス許可を持つユーザーは、すべての より大きなランナー に対するリポジトリ レベルのアクセス権を制御できます。

Organization の所有者は、Organization 内のリポジトリの Enterprise レベルのランナー グループを使用して構成することも、Organization レベルのランナー グループを作成してアクセスを制御することもできます。"Organization ランナーとランナー グループの管理" を持つユーザーは、Organization レベルのランナー グループのみを管理できます。 詳しくは、「カスタム組織の役割の情報」をご覧ください。

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

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

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

Warning

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

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

Note

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

より大きなランナーの名前は編集できます。

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

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

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

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

  3. 左のサイドバーで [アクション] をクリックしてから、 [ランナー] をクリックします。

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

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

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

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

  1. GitHub の右上隅にあるプロフィール写真をクリックします。
  2. ご自分の環境に応じて、[Your enterprise] または [Your enterprises] をクリックし、表示するエンタープライズをクリックします。
  3. ページの左側にある Enterprise アカウントのサイドバーで、 [ポリシー] をクリックします。
  4. 「 ポリシー」で、[アクション] をクリックします。
  5. [Runners](ランナー) タブをクリックします。
  6. ランナーの一覧で、編集するランナーを選びます。
  7. [名前] のテキスト フィールドにランナーの新しい名前を入力します。
  8. [保存] をクリックします。

より大きなランナーの自動スケーリングを構成する

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

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

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

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

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

  3. 左のサイドバーで [アクション] をクリックしてから、 [ランナー] をクリックします。

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

  5. [自動スケーリング] セクションの [最大ジョブ コンカレンシー] に、同時に実行できるジョブの最大数を入力します。

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

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

  1. GitHub の右上隅にあるプロフィール写真をクリックします。
  2. ご自分の環境に応じて、[Your enterprise] または [Your enterprises] をクリックし、表示するエンタープライズをクリックします。
  3. ページの左側にある Enterprise アカウントのサイドバーで、 [ポリシー] をクリックします。
  4. 「 ポリシー」で、[アクション] をクリックします。
  5. [Runners](ランナー) タブをクリックします。
  6. ランナーの一覧で、編集するランナーを選びます。
  7. [自動スケーリング] セクションの [最大ジョブ コンカレンシー] に、同時に実行できるジョブの最大数を入力します。
  8. [保存] をクリックします。

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

Note

静的 IP アドレスを使うには、組織が GitHub Enterprise Cloud を使用している必要があります。 GitHub Enterprise Cloud を無料で試す方法の詳細については、「GitHub Enterprise Cloud の試用版を設定する」を参照してください。

より大きなランナー用の静的 IP アドレスを有効にすることができます。 そうすると、静的IP アドレスの範囲がより大きなランナーに割り当てられます。 割り当てられた範囲内のすべての IP アドレスは使用可能であり、CIDR 表記ではありません。 既定では、アカウントの IP 範囲で最大 10 個の異なる より大きなランナー を構成できます。 静的IPアドレス範囲で10以上の大きなランナーを使用したい場合は、GitHub サポート ポータルまでご連絡ください。

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

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

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

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

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

  3. 左のサイドバーで [アクション] をクリックしてから、 [ランナー] をクリックします。

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

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

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

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

  1. GitHub の右上隅にあるプロフィール写真をクリックします。
  2. ご自分の環境に応じて、[Your enterprise] または [Your enterprises] をクリックし、表示するエンタープライズをクリックします。
  3. ページの左側にある Enterprise アカウントのサイドバーで、 [ポリシー] をクリックします。
  4. 「 ポリシー」で、[アクション] をクリックします。
  5. [Runners](ランナー) タブをクリックします。
  6. ランナーの一覧で、編集するランナーを選びます。
  7. ランナーに静的 IP アドレスを割り当てるには、[ネットワーク] の下の [このランナーに一意の静的パブリック IP アドレス範囲を割り当てる] をオンにします。
  8. [保存] をクリックします。