GitHub Copilot コード レビュー用のランナーの構成

GitHub には、セルフホスト ランナーまたはより大きなCopilotコード レビュー ホスト ランナーを使用します。

この記事で

コード レビュー ツール GitHub Actions 使用について

Copilotコード レビュー では、 GitHub Actions を使用して、完全なプロジェクト コンテキストの収集や パブリック プレビューの機能など、エージェント機能を実行します。 既定では、 Copilotコード レビュー は GitHubホストランナーを使用します。 アクションの分数は、プライベート リポジトリのレビューに対するアカウントまたは組織の既存のプランエンタイトルメントから消費され、含まれている分数を超える使用量は標準の GitHub Actions 料金で課金されます。

組織が GitHubホストランナーを無効にしている場合、エージェント機能は使用できません。 この場合、コード レビューは、より限定的なレビューにフォールバックします。 このような状況の組織では、セルフホステッド ランナーを使用できます。

パフォーマンスを向上させるために、より大きな GitHubホストランナーにアップグレードすることもできます。

コード レビュー用にセルフホステッド ランナーを構成する

ARC (アクション ランナー コントローラー) を備えたセルフホスト Copilotコード レビュー ランナーを使用して、GitHub Actions を実行します。 まず、ご利用の環境で ARC マネージド スケール セットを設定する必要があります。 ARC の詳細については、「 アクション ランナー コントローラー」を参照してください。

警告

ARC は、セルフホスティング Copilotコード レビューに対して公式にサポートされている唯一のソリューションです。 セキュリティ上の理由から、ARC 以外のセルフホステッド ランナーは使用しないでください。

Copilotコード レビュー は、Ubuntu x64 Linux ランナーとのみ互換性があります。

Copilotコード レビューのセルフホステッドランナーを設定するには:

  1. GitHub Actionsがネットワークやパブリック インターネットにオープン アクセスできないように、Copilotコード レビュー ランナーのネットワーク セキュリティ制御を構成します。

GitHub Actionsへの接続と、次のホスト許可するようにファイアウォールを構成する必要があります。

* `api.githubcopilot.com`
* `uploads.github.com`
* `user-images.githubusercontent.com`

  1. copilot-setup-steps.yml ファイルで、runs-on属性を ARC マネージド スケール セット名に設定します。 詳細については、「開発環境を構成する」を参照してください。

    # ...

jobs:
  copilot-setup-steps:
    runs-on: arc-scale-set-name
    # ...

より大きな GitHubホスト上のGitHub Actionsランナーにアップグレードする

既定では、 Copilotコード レビュー は標準の GitHub Actions ランナーで実行されます。 ランナーのサイズが大きいほど、パフォーマンス（CPUとメモリ）が向上し、ディスク容量が増加します。また、Azureのプライベートネットワーキングなどの高度な機能も利用可能です。 「より大きなランナー」を参照してください。

メモ

より大きな GitHubホストランナーの使用量は、分単位でより高いレートで課金されます。 詳細については、「GitHub Actions の課金」を参照してください。

  1. 組織用に大きなランナーを設定してください。 「より大きなランナーを管理する」を参照してください。

  2. Azureプライベート ネットワークで大規模なランナーを使用している場合は、次のホストへの送信アクセスを許可するようにAzureプライベート ネットワークを構成します。

    • api.githubcopilot.com
    • uploads.github.com
    • user-images.githubusercontent.com

  3. copilot-setup-steps.yml ファイルでは、runs-on 属性を、Copilotコード レビュー で使用する大きなランナーに対応するラベルに設定します。 「より大きなランナーでジョブを実行する」を参照してください。

    # ...

jobs:
  copilot-setup-steps:
    runs-on: ubuntu-4-core
    # ...

組織レベルでランナーを構成する

組織の所有者は、組織内のすべてのリポジトリで Copilotコード レビュー と Copilot クラウドエージェント の既定のランナーの種類を設定し、個々のリポジトリがこの既定値をオーバーライドできるかどうかを制御できます。

メモ

組織レベルのランナーの種類は、 Copilotコード レビュー と Copilot クラウドエージェントの両方に適用されます。 [リポジトリにcopilot-setup-steps.ymlする] を無効にしない限り、リポジトリは **** を使用して組織の既定値をオーバーライドできます。 詳細については、「GitHub Copilotクラウドエージェント用ランナーを組織に構成する方法」を参照してください。

これは、組織が特定のランナーで実行するすべてのコード レビューと クラウド エージェント タスクを必要とする場合に便利です。たとえば、より大きなランナーを使用してパフォーマンスを向上させたり、内部リソースにアクセスできるセルフホステッド ランナーを使用したりする場合に便利です。

  1. GitHub の右上隅にあるプロフィール画像をクリックしてから、[ Your organizations] をクリックします。

  2. 組織をクリックして選択します。

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

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

  4. サイドバーの [コード、計画、自動化] の下の [ Copilot] をクリックし、[ ランナーの種類] をクリックします。

  5. [ランナーの種類の構成] の横にある [ ] をクリックします。

  6. [ランナーの種類の編集] ダイアログで、組織全体で既定で使用するランナーの種類を選択し、[ ランナーの選択内容を保存] をクリックします。

    • 標準 GitHub ランナー: Copilotコード レビュー と Copilot クラウドエージェント は、標準の GitHubホストランナーを使用します。
    • ラベル付きランナー: Copilotコード レビュー と Copilot クラウドエージェント は、指定したラベルに一致するランナーを使用します。

  7. 必要に応じて、個々のリポジトリが copilot-setup-steps.yml ファイルを使用して組織レベルのランナー構成をオーバーライドできないようにするには、[リポジトリに ランナーの種類をカスタマイズすることを許可する] を無効にします。