クラウド サンドボックスについて GitHub Copilot

クラウド サンドボックスについて

クラウド サンドボックスは、Copilot が GitHub セッション用に作成する、分離された Linux 環境です。 1 つ以上のリポジトリで作業する場合は、Copilot が各リポジトリをサンドボックスに複製し、コマンドとテストを実行し、そこで変更を加えます。 セッションはお使いのマシン上で実行されないため、ローカル リソースを使用せずに複数のセッションを並列で実行できます。また、Copilot が処理している間も接続を維持する必要はありません。

自分でクラウド サンドボックスを作成したり管理したりすることはありません。 GitHub は、クラウドで実行されるセッションを開始するときに 1 つ作成します。

クライアント間でセッションを続行する

クラウド サンドボックス セッションは GitHub でホストされるインフラストラクチャで実行されるため、セッションが最初に開始された場所に関係なく、任意のクライアントで Copilot セッションを再開できます。 これにより、ファイルのコピーや依存関係の再インストールを必要とせずに、より柔軟なワークフローが可能になります。

コンピューティング集中型ワークフローをオフロードする

ローカル リソースを消費することなく、クラウドで複数の Copilot セッションを並列で実行できます。 これにより、エージェント駆動型の作業をスケーリングしながら、ローカル環境の軽量で応答性が維持されます。

クラウド サンドボックスとローカル サンドボックス

クラウド サンドボックスとローカル サンドボックスは、異なる問題を解決します。 クラウド サンドボックスは、セッション全体を端末の外部で実行します。 ローカル サンドボックスはセッションをマシン上に保持しますが、Copilot がアクセスできるリソースを制限します。

ローカル サンドボックスの詳細については、「 ローカル サンドボックスについて GitHub Copilot」を参照してください。

Copilot でクラウド サンドボックスを使用する場面

既定では、次のいずれかの場所から Copilot を起動すると、クラウド サンドボックスでクラウド セッションが実行されます。

• GitHub Web サイトのチャット インターフェイス

• GitHub Mobile

• Slack とMicrosoft Teams

• GitHub Copilot app

• Visual Studio Code

• Copilot SDK のクラウド セッション

Copilot CLIでは、セッションは既定であなたのマシン上で実行されます。 また、クラウド サンドボックスでセッションを開始することもできます。 Copilot CLI からクラウド セッションを開始するを参照してください。

Copilotの実行場所の選択

Copilot は、次のいずれかの環境でセッションを実行できます。

• クラウド: Copilot は、GitHub がホストするクラウド サンドボックスでセッションを実行します。
• アクション: Copilot cloud agent は、GitHub Actions ホストランナーまたは構成したランナー上の GitHub ジョブでセッションを実行します。

セッションは、Copilot CLI や GitHub Copilot app など、手元のマシンで実行することもできます。 これらのセッションでは、クラウド サンドボックスは使用されません。

クラウドとアクションのどちらかを選択できる場合は、クラウドが既定です。 セッションの開始時に環境を選択し、後で変更することはできません。 別の環境を使用するには、新しいセッションを開始してください。

選択方法と選択できる環境は、セッションを開始するクライアントによって異なります。 各クライアントの手順については、 GitHub Copilot セッションの開始 を参照してください。

リポジトリが、セットアップ手順、大規模またはセルフホステッド ランナー、Windows開発環境など、**** でのみ動作するカスタマイズに依存している場合は、GitHub Actionsを選択します。 それ以外の場合は、Cloudを使用します。 詳細については、「クラウド サンドボックス セッションのカスタマイズ」を参照してください。

Copilot CLI からクラウド セッションを開始する

クラウド サンドボックスで Copilot CLI セッションを開始するには、次のコマンドを実行します。

copilot --cloud

copilot --cloud

--cloudコマンド ライン オプションは、クラウド サンドボックス内で対話型のCopilot CLI セッションを起動します。 ローカル セッションと同じように、 Copilot にタスクの実行、シェル コマンドの実行、コードの反復処理を求めることができます。 Copilot が実行するコマンドは、ローカル コンピューターではなくクラウド サンドボックスで実行されます。

--cloud オプションは、このオプションを付けて開始したセッションにのみ適用されます。 クラウド サンドボックスで別のセッションを実行するには、--cloud でもう一度 CLI を開始します。 --cloudは対話型セッションにのみ使用できるため、-pまたは-iオプションと組み合わせることはできません。

セッションのライフサイクル

セッションに戻ると、ファイルと進行中の作業はそのままの状態でセッションが再開されます。 セッションが停止している間、クラウド サンドボックスは状態のスナップショットを保持するため、中断したところから再開できます。

分離とネットワーク アクセス

各クラウド サンドボックスは、お使いのマシンや他のセッションから分離されます。 セッションはコンピューター上で実行されないため、Copilot がクラウド サンドボックスで実行するコマンドは、コンピューター上のファイルを読み取ったり変更したりすることはできません。

クラウド サンドボックスからのネットワーク アクセスは、 Copilot cloud agentと同じファイアウォール設定に従います。これには、推奨される許可リストや、組織またはリポジトリの所有者が追加するカスタム許可リストルールが含まれます。 詳細については、「GitHub Copilotのファイアウォールのカスタマイズまたは無効化」を参照してください。

Copilot が許可リストにないホストに到達する必要がある場合は、そのホストを許可リストに追加してから、新しいセッションを開始してください。 許可リストの変更は、既に実行されているセッションには適用されません。

クラウド サンドボックス セッションのカスタマイズ

クラウド サンドボックスの設定は 、github.com/copilot/customize でカスタマイズできます。 ルート .copilot ディレクトリを持つ dotfiles リポジトリを使用して、個人の指示、スキル、およびカスタム エージェントをクラウド サンドボックス セッションに取り込むこともできます。 インストール スクリプトを実行せずに、サンドボックスの作成時または再開時に Dotfiles がコピーされます。 このパーソナル化は、 GitHub Actions ベースのセッションでは使用できません。 セットアップ ガイダンスについては、クラウド セッションのパーソナライズを参照してください。

その他のカスタマイズでは GitHub Actionsを使用するため、アクションで実行されるセッションにのみ適用されます。これには次が含まれます:

• OpenID Connect (OIDC) を使用してクラウド プロバイダーにサインインする手順を含む、 copilot-setup-steps.yml ファイルのセットアップ手順
• 大容量のセルフホステッド ランナー
• Windows開発環境

リポジトリがこれらのいずれかに依存している場合は、タスクを委任するときに [アクション] を選択してください。 詳細については、「GitHub Actions上のエージェントの開発環境を構成する」を参照してください。

より高度にカスタマイズしたい場合は、Linux マシンまたはコードスペースをカスタム環境として登録し、カスタム環境をサポートするクライアントで選択できます。 クラウド サンドボックスとは異なり、ユーザーがホスト、そのツールと依存関係、およびそのライフサイクルを管理します。 「エージェント用のカスタム環境の作成」を参照してください。

Access

クラウド サンドボックスでは、既存の Copilot 認証が使用されます。 別のクラウド プロバイダーを構成したり、API キーを管理したり、インフラストラクチャを設定したりする必要はありません。

クラウド サンドボックスには、個別のアクセス ポリシーはありません。 Copilot を組織または企業を通じて入手した場合、Copilot in the cloud ポリシーは、クラウド サンドボックスで実行されるセッションを開始できるかどうかを制御します。 ポリシーは既定で有効になっています。 管理者の詳細については、 組織または企業のクラウド サンドボックスの管理 を参照してください。

Billing

クラウド サンドボックスは使用量に基づいて課金されます。 GitHub は、3 メートルにわたるクラウド サンドボックスの使用状況を測定します。

クラウド サンドボックスの使用状況の測定と課金方法の詳細については、「 GitHub Copilot 向けのクラウドとオンプレミス型サンドボックスの請求」を参照してください。

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

• ローカル サンドボックスについて GitHub Copilot
• 組織または企業のクラウド サンドボックスの管理
• GitHub Copilot 向けのクラウドとオンプレミス型サンドボックスの請求
• GitHub Actions上のエージェントの開発環境を構成する