Configuring larger runners for default setup

You can run code scanning default setup more quickly on bigger codebases using より大きなランナー (larger runner).

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

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

この記事の内容

メモ

code scanning の既定のセットアップに対する より大きなランナー (larger runner) のサポートは、現在 パブリック プレビュー であり、変更される可能性があります。

About より大きなランナー (larger runner) for default setup

GitHub Team プランと GitHub Enterprise Cloud プランのお客様は、標準の GitHub ホステッド ランナーよりも多くのリソースを持つさまざまなマネージド仮想マシンから選択できます。 これらのマシンは "より大きなランナー (larger runner)" と呼ばれます。 これらには、次の高度な機能が用意されています。

  • 追加の RAM、CPU、ディスク領域
  • 静的 IP アドレス
  • Azure プライベート ネットワーク
  • ランナーをグループ化する機能
  • 同時実行ワークフローをサポートするための自動スケール
  • GPU 搭載ランナー

これらの より大きなランナー (larger runner) は、GitHub によってホストされ、ランナー アプリケーションとその他のツールをプレインストールしています。 For more information about より大きなランナー (larger runner), see より大きなランナー.

Consider configuring より大きなランナー (larger runner) for default setup if:

  • Your scans with standard GitHub-hosted runners are taking too long.
  • Your scans with standard GitHub-hosted runners are returning memory or disk errors.
  • You want to customize aspects of your code scanning runner like the runner size, runner image, and job concurrency without using self-hosted runners.

警告

Currently, Swift analysis is not available on より大きなランナー (larger runner) for default setup. Additionally, if your repository has access to a runner with the code-scanning label, such as a より大きなランナー provisioned for default setup, default setup workflows will only use runners labeled code-scanning. If you would like to configure default setup on より大きなランナー (larger runner) and analyze Swift, you have two options:

Provisioning enterprise-level より大きなランナー (larger runner) for default setup

  1. Add a より大きなランナー to your enterprise. For more information, see より大きなランナーを管理する.
    • To add the code-scanning label to your より大きなランナー, name the runner code-scanning. An enterprise can only have one より大きなランナー named code-scanning, and that runner will handle all code scanning jobs for all organizations and repositories within your enterprise that:
      • Have access to the enterprise-level runner, and
      • Don't have access to an organization-level より大きなランナー named code-scanning. If an organization or repository also has access to an organization-level より大きなランナー named code-scanning, each code scanning job will be randomly assigned to either the organization-level or enterprise-level runner.
  2. Organization がより大きなランナーにアクセスできるようにするには、ランナーが割り当てられているランナー グループを使用できる Organization を指定します。 詳しくは、「より大きなランナーへのアクセスの制御」をご覧ください。
  3. To analyze repositories with default setup, grant the desired repositories access to the runner group your より大きなランナー is assigned to. For more information, see より大きなランナーを管理する.
  4. You can now configure default setup for your enterprise, organizations, and repositories, and your より大きなランナー will automatically pick up code scanning jobs as previously specified. For more information on configuring default setup, see Configuring default setup for code scanning and 大規模なコード スキャンの既定のセットアップを構成する.

Provisioning organization-level より大きなランナー (larger runner) for default setup

  1. Add a より大きなランナー to your organization. See より大きなランナーを管理する.
    • To add a custom label to your より大きなランナー, give the runner a name that matches that label. You can use this custom label when you configure default setup with より大きなランナー (larger runner). For more information, see Configuring default setup for code scanning.
  2. By default, all repositories in your organization have access to organization-level runners, meaning every repository can use your より大きなランナー. For information on granting only select repositories access to a より大きなランナー, see より大きなランナーを管理する.
  3. You can now configure default setup for your organization and repositories, and your より大きなランナー will automatically pick up code scanning jobs. For more information on configuring default setup, see Configuring default setup for code scanning and 大規模なコード スキャンの既定のセットアップを構成する.