Filestore 代理卷简介

Filestore 智能体存储卷是一种全代管式高密度弹性 NFS 文件存储功能，专为有状态 AI 智能体沙盒、自主智能体集群和多智能体开发者环境而构建。

Filestore 智能体存储卷提供在智能体执行期间维护状态、上下文和历史记录所需的永久性存储层，从而实现低延迟工作负载、高密度计算利用率和强大的沙盒隔离。您还可以将 Filestore 智能体存储卷用于任何智能体工作区需求，因为智能体原生支持文件系统。

虽然卷池和卷主要针对 AI 智能体工作负载和开发者沙盒而设计，但它们也为需要多个轻量级独立文件系统的应用提供了通用文件存储架构。

使用场景

Filestore 智能体存储卷专为需要许多快速装载文件系统的架构而设计。常见用例包括：

• 有状态 AI 智能体沙盒：为交互式编码智能体和自主工作流提供永久性存储，支持在暂停和恢复周期内实现不到 100 毫秒的卷重新挂接。
• 协作式多智能体集群：使专业智能体团队能够通过符合 POSIX 标准的 ReadWriteMany (RWX) 访问和字节范围锁定，同时处理共享代码库。
• 高密度开发环境：托管多租户云 IDE 和开发者沙盒，伸缩到多达 2,000 万个隔离卷，其中最多包含 50,000 个活跃卷和多达 400 TiB 的 HOT 容量（包括 COLD 存储在内，最多可达 5 PB），由单个区域级容量池提供支持。
• CI/CD 流水线和自动化测试：为测试运行程序和构建流水线预配短期、隔离的存储空间，实现亚秒级 API 响应。
• 工作区克隆和分支：通过快照即时创建现有智能体环境的副本，以便在几秒钟内分叉任务、分支代码实验或创建测试运行器，而无需重复基准数据传输。

Filestore 智能体存储卷工作流

下图展示了 Filestore 智能体存储卷、Private Service Connect (PSC) 和 Google Kubernetes Engine 在智能体会话期间如何协同工作：

1. GKE 集群通过 PSC 服务连接政策与代管式存储平面进行通信。所有存储和 NFS 流量在虚拟私有云 (VPC) 网络中保持私密，无需外部 IP 地址或 VPC 对等互连。
2. 区域级卷池会为您的项目预留共享容量和 IOPS。请求代理会话时，系统会在一到两秒内使用 Filestore CSI 驱动程序或 API 从池中预配单个卷。
3. GKE 会调度一个使用 gVisor 隔离的容器 Pod。Filestore CSI 驱动程序会非常快速地将卷挂接并装载到 Pod 的工作区目录，通常不到 100 毫秒。
4. 智能体在沙盒内初始化，立即访问其专用文件系统，以克隆 Git 代码库、安装软件包并写入暂存器工件。当智能体处于空闲状态时，GKE 可以终止计算 Pod 以节省费用，而卷会保留所有工作区状态，以便即时恢复。

核心功能

Filestore 智能体存储卷提供以下核心功能：

• 超高卷密度：在单个区域卷池中预配多达 2,000 万个独立卷（最多 50, 000 个并发活跃卷，以及最多 400 TiB 的 HOT 容量，或最多 5 PB 的容量，包括 COLD 存储空间）。
• 秒级操作：使用 REST API 在一到两秒内创建和删除卷，与自主智能体任务的临时生命周期相匹配。
• 存储空间挂接时间低于 100 毫秒：在 100 毫秒内将现有卷装载到预热沙盒中，从而实现即时交互式用户会话和计算基础设施的高利用率。
• POSIX 合规性和 RWX 共享：在多个容器和节点之间提供 NFSv3 文件系统语义、目录层次结构和字节范围文件锁定。
• 安全连接：使用 Private Service Connect (PSC) 服务连接政策安全地连接到 VPC 网络。
• Workspace 分层：自动将分离的智能体工作区移至低成本的 COLD 层，并在智能体恢复时在几秒钟内将其恢复到 HOT 层。
• 从快照克隆工作区：使用 createFromSource API，在几秒钟内直接从卷快照中派生现有智能体工作区。
• 动态的每个卷 IP ACL：在挂接和分离时，将 NFS 装载权限动态限制为特定的沙盒 Pod IP 地址。

卷池和卷

Filestore 智能体存储卷引入了简化的两层资源模型。底层存储基础设施由系统代为管理，因此您无需管理或配置文件服务器实例：

• 卷池：顶级代管式区域级资源。卷池会为项目和 VPC 网络预留存储容量和 IOPS 的共享池，并强制执行默认卷配额政策。卷池支持使用 activeVolumeIops 参数自定义预配 IOPS 分配。
• 卷：在卷池中预配的符合 POSIX 标准的单个存储资源。每个卷都代表一个独立的文件系统，可以装载到一个或多个容器、Pod 或虚拟机中。

卷生命周期和工作区层级

Filestore 智能体存储卷支持集成式生命周期和工作区层级模型，旨在最大限度地降低间歇性或突发性智能体工作负载的存储成本：

• CREATING：正在从池中预配卷。
• HOT：卷已装载，并以高性能主动处理 I/O。
• COLD：工作区文件系统会序列化到低成本的区域级云对象存储区。在分离的卷的 IP ACL 在池的自动冻结时长（默认为 7 天）内被清除后，或者在使用 volumes.patch API 按需清除后，系统会自动分层到 COLD。当代理会话恢复时，unfreeze API 调用会在几秒钟内将卷从 COLD 层级恢复到 HOT 层级。

价格和结算模式

Filestore 智能体存储卷引入了按用量付费的容量模式，并结合了预配 IOPS 结算，无需最低容量承诺，也不收取基础存储卷池每小时费用。如需了解详情，请参阅 Filestore 价格页面。

使用 Filestore 智能体存储卷

完成一次性项目和网络设置并创建卷池后，您可以使用 GKE 或您自己的编排框架集成 Filestore 智能体存储卷：

使用 GKE 部署智能体存储卷

在 GKE 上运行代理工作负载时，Filestore CSI 驱动程序会自动预配、挂接和管理卷池中的卷。首先设置 GKE 环境，然后选择与您的工作负载匹配的 GKE 模式：

• GKE Agent Substrate：使用 GKE Agent Substrate 管理有状态 Agent Sandbox 的生命周期。Agent Substrate 会暂停空闲智能体以节省计算费用，并在不到一秒的时间内恢复它们，而 Filestore 智能体存储卷会在暂停和恢复操作期间持久保存工作区文件系统状态。如需了解详情，请参阅将 Filestore 智能体存储卷与 GKE Agent Substrate 搭配使用。
• GKE Agent Sandbox：使用 GKE Agent Sandbox，通过预热的 gVisor 沙盒池管理隔离的有状态智能体环境的生命周期。如需了解详情，请参阅将 Filestore 智能体存储卷与 GKE Agent Sandbox 搭配使用。
• 动态存储后期绑定：对于对延迟时间要求极高的交互式平台，使用主机守护进程和装载传播，在 100 毫秒内将预配的 NFS 卷注入预热的运行中沙盒 Pod，从而消除 Pod 重启延迟时间。如需了解详情，请参阅将 Filestore 智能体存储卷与 Agent Sandbox 动态存储后期绑定搭配使用。
• 自行管理的 GKE 工作负载：部署标准 Kubernetes Deployment、StatefulSet 或 Job 工作负载，并使用由 Filestore CSI 驱动程序和卷池 StorageClass 资源提供支持的 PersistentVolumeClaim (PVC) 资源。如需了解详情，请参阅将 Filestore 智能体存储卷与自行管理的 GKE 工作负载搭配使用。

使用您自己的编排框架部署智能体存储卷

如果您运行自定义代理编排器、基于虚拟机的沙盒或非 Kubernetes 容器平台，则控制平面可以使用 Filestore REST API 直接预配和管理各个卷：

• 在 1 到 2 秒内按需预配和删除卷。
• 通过 Private Service Connect 将返回的 NFSv3 mountPoint 直接装载到虚拟机或容器中。
• 从快照克隆工作区、更新每个卷的配额和 IP ACL，以及在 COLD 和 HOT 层级之间对卷进行分层。

请参阅将智能体存储卷与您自己的编排框架搭配使用。

后续步骤

• 设置 Filestore 智能体存储卷。
• 创建和管理卷池。
• 设置 GKE 环境或直接使用 REST API 管理卷。