Filestore エージェント ボリュームは、ステートフル AI エージェント サンドボックス、自律型エージェント フリート、マルチエージェント デベロッパー環境向けに構築された、フルマネージドの高密度エラスティック NFS ファイル ストレージ機能です。
Filestore エージェント ボリュームは、エージェントの実行間で状態、コンテキスト、履歴を維持するために必要な永続ストレージ レイヤを提供し、低レイテンシのワークロード、高密度のコンピューティング使用率、強力なサンドボックス分離を実現します。エージェントはファイル システムでネイティブに動作するため、Filestore エージェント ボリュームは、エージェントのワークスペースやスクラッチパッドのニーズにも使用できます。
主に AI エージェント ワークロードとデベロッパー サンドボックス向けに設計されていますが、ボリューム プールとボリュームは、複数の軽量で独立したファイル システムを必要とするアプリケーション向けの汎用ファイル ストレージ アーキテクチャも提供します。
ユースケース
Filestore エージェント ボリュームは、多数の軽量で高速なマウント ファイル システムを必要とするアーキテクチャ向けに設計されています。一般的なユースケースは次のとおりです。
- ステートフル AI エージェント サンドボックス: インタラクティブ コーディング エージェントと自律型ワークフローに永続ストレージを提供し、一時停止と再開のサイクル全体で 100 ミリ秒未満のボリューム再アタッチをサポートします。
- 協調型マルチエージェント スワーム: 専門エージェントのチームが、POSIX 準拠の ReadWriteMany（RWX）アクセスとバイト範囲ロックを使用して、共有リポジトリで同時に作業できるようにします。
- 高密度のデベロッパー環境: マルチテナント クラウド IDE とデベロッパー サンドボックスをホストし、単一のリージョン容量プールで最大 100 万個の分離されたボリュームにスケーリングします。
- エフェメラル CI/CD と自動テスト: テストランナーとビルド パイプライン用に、API ターンオーバーが 1 秒未満の短期間の分離ストレージをプロビジョニングします。
- 信頼できないコードの安全な実行: ルート スカッシュ（
root_squash）を使用して基盤となるストレージを保護し、GKE の gVisor コンテナ サンドボックス内でモデル生成コードを安全に実行します。
GKE 上のステートフル エージェント ワークフロー
次の図は、エージェント セッション中に Filestore エージェント ボリューム、Private Service Connect（PSC）、GKE が連携する仕組みを示しています。
- GKE クラスタは、PSC サービス接続ポリシーを介してマネージド ストレージ プレーンと通信します。すべてのストレージと NFS トラフィックは、外部 IP アドレスや VPC ピアリングを必要とせずに、Virtual Private Cloud（VPC）ネットワーク内でプライベートなままです。
- リージョン ボリューム プールは、プロジェクト用に共有容量と IOPS を予約します。エージェント セッションがリクエストされると、Filestore CSI ドライバまたは API を使用して、プールから個々のボリュームが 1 秒以内にプロビジョニングされます。
- GKE は、gVisor で分離されたコンテナ Pod をスケジュールします。Filestore CSI ドライバは、100 ミリ秒以内にボリュームを Pod のワークスペース ディレクトリ（
/workspaceなど）にアタッチしてマウントします。 - エージェントはサンドボックス内で初期化され、専用のファイル システムにすぐにアクセスして、Git リポジトリのクローンを作成し、パッケージをインストールして、スクラッチパッド アーティファクトを書き込みます。エージェントがアイドル状態になると、GKE はコンピューティング Pod を終了してコストを削減できます。その間、ボリュームはすべてのワークスペースの状態を保持し、すぐに再開できます。
中核となる機能
Filestore エージェント ボリュームは、次のコア機能を提供します。
- 超高ボリューム密度: 単一のリージョン ボリューム プール内に最大 100 万個の独立したボリュームをプロビジョニングします。
- 1 秒未満のオペレーション: REST API を使用して 1 秒未満でボリュームを作成および削除し、自律エージェント タスクのエフェメラル ライフサイクルに一致させます。
- 100 ミリ秒未満のストレージ アタッチ: 既存のボリュームを 100 ミリ秒未満で事前準備済みのサンドボックスにマウントし、インタラクティブなユーザー セッションを即座に開始して、コンピューティング インフラストラクチャの使用率を高めます。
- POSIX 準拠と RWX 共有: 複数のコンテナとノードにわたって NFSv3 ファイル システム セマンティクス、ディレクトリ階層、バイト範囲ファイル ロックを提供します。
- プライベート VPC 接続: Private Service Connect（PSC）サービス接続ポリシーを使用して、VPC ネットワークに安全に接続します。
ボリューム プールとボリューム
Filestore エージェント ボリュームでは、簡略化された 2 階層のリソースモデルが導入されています。基盤となるストレージ インフラストラクチャはユーザーが管理するため、ファイル サーバー インスタンスの管理や構成は不要です。
- ボリューム プール: 最上位のマネージド リージョン リソース。ボリューム プールは、プロジェクトと VPC ネットワーク用にストレージ容量と IOPS の共有プールを予約し、デフォルトのボリューム割り当てポリシーを適用します。
- ボリューム: ボリューム プール内にプロビジョニングされた個別の POSIX 準拠のストレージ リソース。各ボリュームは、1 つ以上のコンテナ、Pod、VM にマウントできる分離されたファイル システムを表します。
サポートされているワークロード パターン
複数のオーケストレーション モデルを使用して、Filestore エージェント ボリュームをアーキテクチャに統合できます。
- GKE Agent Substrate: GKE Agent Substrate を使用して、ステートフル エージェント サンドボックスのライフサイクルを管理します。Agent Substrate は、コンピューティング費用を節約するためにアイドル状態のエージェントを一時停止し、1 秒以内に再開します。一方、Filestore エージェント ボリュームは、一時停止と再開のオペレーション全体でワークスペース ファイル システムの状態を保持します。詳細については、GKE Agent Substrate で Filestore エージェント ボリュームを使用するをご覧ください。
- GKE Agent Sandbox: GKE Agent Sandbox を使用して、ウォームアップ済みのサンドボックス プールで分離されたステートフル エージェント環境のライフサイクルを管理します。詳細については、GKE Agent Sandbox で Filestore エージェント ボリュームを使用するをご覧ください。
- 動的ストレージの遅延バインディング: レイテンシが重要なインタラクティブ プラットフォームの場合、ホスト デーモンとマウント伝播を使用して、事前プロビジョニングされた NFS ボリュームを事前ウォームアップされた実行中のサンドボックス Pod に 100 ミリ秒未満で挿入し、Pod の再起動レイテンシを排除します。詳細については、エージェント サンドボックスの動的ストレージの遅延バインディングで Filestore エージェント ボリュームを使用するをご覧ください。
- セルフマネージド GKE ワークロード: Filestore CSI ドライバとボリューム プール
StorageClassリソースを基盤とするPersistentVolumeClaim（PVC）リソースを使用して、標準の KubernetesDeployment、StatefulSet、またはJobワークロードをデプロイします。詳細については、セルフマネージド GKE ワークロードで Filestore エージェント ボリュームを使用するをご覧ください。
次のステップ
- Filestore エージェント ボリュームを設定します。
- ボリューム プールを作成して構成します。
- Filestore エージェント ボリュームの GKE 環境を構成します。