用途:在 TrueFoundry 上创建和管理持久卷(Volume),提供跨容器重启持久、可被多个 Pod 共享的低延迟磁盘存储。适用于需要多 Pod 并发文件系统访问、文件系统语义(锁、重命名、目录列举)、低延迟读取(模型权重、配置文件)以及 ML 训练检查点写入的场景。数据超过数百 GB、需跨区域访问或成本敏感时,应改用 S3/GCS 等 Blob 存储。
主要能力:动态卷(新建 PVC,指定大小与存储类,访问模式 ReadWriteMany,回收策略 Retain,大小可扩不可缩);静态卷(按名称挂载已有 Kubernetes PV,支持 AWS EFS/S3、GCP Filestore/GCS、Azure Files/Blob 等 CSI 驱动);列出与查看卷;将卷挂载到 Service 或 Job;可选 Volume Browser 网页文件管理界面;LLM 部署可用 cache_volume 缓存模型权重。
使用方式:需先设置 TFY_BASE_URL、TFY_API_KEY,并明确 TFY_WORKSPACE_FQN(卷为工作区级,不可自动选择)。创建前需依次确认卷类型、名称、大小(GB 整数)、存储类、工作区,以及是否启用 Volume Browser(需端点主机、路径、用户名、密码密钥 FQN)。可通过工具调用或直接 API 操作,例如: $TFY_API_SH PUT /api/svc/v1/apps '{"manifest":{"type":"volume","name":"my-volume","config":{"type":"dynamic","size":100,"storage_class":"efs-sc"}},"workspaceId":"ws-id-here"}' 列出:$TFY_API_SH GET '/api/svc/v1/apps?workspaceFqn=my-cluster:my-workspace&applicationType=volume' 挂载时卷 FQN 格式为 {cluster}:{workspace}:{volume-name},在 SDK 中使用 VolumeMount(mount_path="/data", volume_fqn="..."),或在 manifest 的 mounts 中指定 type、mount_path、volume_fqn。
限制与注意:卷与工作区绑定,应用必须与卷在同一工作区;目标集群需具备对应存储类的供给器;静态卷要求 K8s 中 PV 已存在;大小只能扩展不能缩减;禁止多个 Pod 同时写同一文件路径,否则可能数据损坏,应按 Pod 使用子目录。资料未提供具体价格与性能数值。