Skip to main content

GitHub Copilotクラウドエージェント用ランナーを組織に構成する方法

GitHub Actionsによって使用されるCopilot クラウドエージェント ランナーを構成し、リポジトリがランナーの種類をカスタマイズできるかどうかを制御します。

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

Organization owners

Copilot クラウドエージェント は、すべての有料 Copilot プランで使用できます。

エージェントは、GitHubが所有し、明示的に無効にされているリポジトリを除き、マネージド ユーザー アカウントに格納されているすべてのリポジトリで使用できます。
Contact Sales

組織レベルのランナー コントロールについて

既定では、 Copilot クラウドエージェント は標準の GitHubホスト GitHub Actions ランナー (ubuntu-latest) で実行されます。 組織の所有者は、組織内のすべてのリポジトリの既定のランナーの種類を変更し、個々のリポジトリでこの既定値をオーバーライドできるかどうかを選択できます。

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

次の構成を行うことができます。

  • ランナーの種類: 標準の GitHubホストランナーか、特定のランナー グループからラベル付けされたランナーのいずれかを選択します。
  • リポジトリでランナーの種類をカスタマイズできるようにする: Copilotで定義された.github/workflows/copilot-setup-steps.ymlセットアップ 手順ワークフローを使用して、リポジトリが組織の既定値をオーバーライドできるかどうかを制御します。

既定ランナー種別の設定

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

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

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

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

  4. サイドバーの [コード、計画、自動化] で、[ Copilot] をクリックし、[ クラウド エージェント] をクリックします。

  5. [ランナーの種類] の横にある鉛筆アイコン () をクリックします。

  6. 組織全体の Copilot クラウドエージェント に既定で使用するランナーの種類を選択します。

    • 標準 GitHub ランナー: Copilot クラウドエージェント は ubuntu-latestを使用します。
    • ラベル付きランナー: Copilot クラウドエージェント は、指定したグループ名やラベルに一致するランナーを使用します。 [ ランナー] グループ名 フィールドまたは [ ランナー ラベル ] フィールドに値を入力します。
  7. [ ランナーの選択を保存] をクリックします。

リポジトリがランナーの種類をカスタマイズできないようにする

既定では、リポジトリは、Copilotにある.github/workflows/copilot-setup-steps.ymlセットアップ 手順ワークフローを使用して、組織レベルのランナー構成をオーバーライドできます。 すべてのリポジトリで一貫したランナーの種類を適用する場合は、このオプションを無効にすることができます。

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

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

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

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

  4. サイドバーの [コード、計画、自動化] で、[ Copilot] をクリックし、[ クラウド エージェント] をクリックします。

  5. [リポジトリでランナーの種類をカスタマイズできるようにする] で、リポジトリ レベルのカスタマイズを有効または無効にする設定を切り替えます。

    • 有効にすると、リポジトリは、runs-oncopilot-setup-steps ジョブのcopilot-setup-steps.yml フィールドを設定することで、既定のランナーをオーバーライドできます。 「開発環境を構成する」を参照してください。
    • 無効にすると、組織内のすべてのリポジトリで組織レベルのランナーの種類が使用されます。
  6. 保存 をクリックします。

詳細については、次を参照してください。