Repolode
kubernetes-sigs

kubernetes-sigs/agent-sandbox

AIエージェントのランタイムや強化学習ワークロード向けに、分離されたステートフルな単一Podサンドボックスを管理するKubernetesコントローラーとCRD。

スター
4,543
フォーク
607
未解決の Issue
177
最終コミット
22 時間前

これは何?

agent-sandboxは、安定したホスト名とネットワークID、必要に応じた永続ストレージを備えた、長時間稼働する単一コンテナのワークロードを実行するため、SandboxカスタムリソースとコントローラーをKubernetesに追加します。ステートレスで複製されるDeploymentと、番号付きPodのセットを管理するStatefulSetの間にある機能のギャップを埋めます。本プロジェクトはSIG Appsのもとで開発されています。

オプションの拡張モジュールでは、再利用可能なサンドボックス定義のためのSandboxTemplate、事前に起動したサンドボックスを割り当て可能な状態で維持するSandboxWarmPool、完全な設定を扱わずにプールからサンドボックスを要求するSandboxClaimを追加します。Sandbox PodはRuntimeClassを通じてgVisorやKata Containersなどのランタイムで実行するよう設定でき、コントローラーがオーケストレーションを担い、ランタイムが分離を提供します。

GoおよびPython SDKに加えて、クライアントからSandbox Podへトラフィックを転送するHTTPリバースプロキシ、Sandbox Routerも提供します。インストールにはkubectlマニフェストまたはHelmを使用します。

主な機能

  • 01Sandbox CRDにより、安定したホスト名とネットワークIDを持つステートフルな単一Podを利用できます。
  • 02永続ストレージはPodの再起動後も保持できます。
  • 03ライフサイクル管理では、作成、スケジュールに基づく削除、一時停止、再開に対応します。
  • 04SandboxWarmPoolにより、事前に起動したサンドボックスをすばやく割り当てられる状態で維持できます。
  • 05SandboxClaimを使うと、完全な設定を管理せずにプールからサンドボックスを要求できます。
  • 06RuntimeClassを介してgVisorまたはKata Containersを利用できます。
  • 07GoおよびPython SDKを利用できます。

ユースケース

  • AIエージェント向けに、LLMが生成したコードや信頼できないコードを分離環境で実行する。
  • 強化学習や評価のループ向けに、すぐ起動できるサンドボックスを提供する。
  • 永続的なクラウド開発環境やJupyter形式のセッションをホストする。
  • StatefulSetのオーバーヘッドを避けつつ、安定したIDを必要とする単一インスタンスのサービスを実行する。

クイックスタート

  1. 1

    kubectl でコアと拡張機能をインストールします(最新リリース)

    kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/latest/download/sandbox-with-extensions.yaml
  2. 2

    Sandbox CRD がインストールされていることを確認します

    kubectl get crd sandboxes.agents.x-k8s.io
  3. 3

    コンテナイメージを指定して Sandbox マニフェストを適用します

使う前に知っておきたいこと

  • agent-sandbox コントローラーがインストールされた Kubernetes クラスターが必要です。
  • Sandbox の分離には、gVisor や Kata Containers などの別途用意されたランタイムが必要です。

収録されている特集

トピック

よくある質問

agent-sandbox とは?
AIエージェントのランタイムや強化学習ワークロード向けに、分離されたステートフルな単一Podサンドボックスを管理するKubernetesコントローラーとCRD。 agent-sandboxは、安定したホスト名とネットワークID、必要に応じた永続ストレージを備えた、長時間稼働する単一コンテナのワークロードを実行するため、SandboxカスタムリソースとコントローラーをKubernetesに追加します。ステートレスで複製されるDeploymentと、番号付きPodのセットを管理するStatefulSetの間にある機能のギャップを埋めます。本プロジェクトはSIG Appsのもとで開発されています。
agent-sandbox は無料で使えますか?ライセンスは?
agent-sandbox は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
agent-sandbox は今もメンテナンスされていますか?
活発にメンテナンス中。agent-sandbox の最終コミットは 2026年11月7日 です。
agent-sandbox は何に使えますか?
AIエージェント向けに、LLMが生成したコードや信頼できないコードを分離環境で実行する。 強化学習や評価のループ向けに、すぐ起動できるサンドボックスを提供する。 永続的なクラウド開発環境やJupyter形式のセッションをホストする。 StatefulSetのオーバーヘッドを避けつつ、安定したIDを必要とする単一インスタンスのサービスを実行する。
agent-sandbox のインストール方法は?
kubectl でコアと拡張機能をインストールします(最新リリース): kubectl apply -f https://github.com/kubernetes-sigs/agent-sandbox/releases/latest/download/sandbox-with-extensions.yaml Sandbox CRD がインストールされていることを確認します: kubectl get crd sandboxes.agents.x-k8s.io コンテナイメージを指定して Sandbox マニフェストを適用します
agent-sandbox はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/kubernetes-sigs/agent-sandbox

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト