容器服务
容器服务
容器服务
文档指南
请输入
容器服务 VKE
产品动态
Kubernetes 版本发布记录
组件发布记录
监控组件
DNS 组件
GPU 组件
Sandbox 组件
安全公告
产品公告
历史公告
用户指南
集群
节点池
授权
网络
容器网络
服务（Service）
路由（Ingress）
APIG Ingress
ALB Ingress
自定义转发规则配置示例
CLB Ingress
Nginx Ingress
Gateway API
工作负载
存储
数据管理中心（DMC）
对象存储（TOS）
FSX 访问方式
文件存储（NAS）
FSX 访问方式
弹性文件存储（EFS）
文件存储（vePFS）
FSX 访问方式
vePFS Client 访问方式
NFS 访问方式
大数据文件存储（CloudFS）
弹性伸缩
工作负载弹性伸缩
事件驱动伸缩（KEDA）
组件管理
网络组件
监控组件
DNS 组件
GPU 组件
Sandbox 组件
异构计算
调度管理
可观测性
基础观测
诊断与巡检
最佳实践
网络
可观测性
安全合规
API 参考
集群管理
节点池管理
组件管理
机型镜像管理
云原生观测
巡检诊断
弹性容器实例
附录
开发指南
常见问题
通用 FAQ
集群 FAQ
集群管理
集群升级
节点与节点池 FAQ
授权 FAQ
工作负载 FAQ
服务与路由 FAQ
存储 FAQ
弹性伸缩 FAQ
可观测性 FAQ
配额 FAQ
组件 FAQ
容器镜像 FAQ
AI 云原生
推理套件
Helm 模板 AI 应用
Deepseek 实践
Qwen 实践
最佳实践
MiniMax 模型部署
Qwen 模型部署
弹性容器实例 VCI
最新动态
用户指南
虚拟节点
VKE 集群使用虚拟节点
自建/跨云集群使用虚拟节点
创建 VCI 实例
VCI Agent Sandbox
安全合规
- 文档首页
容器服务弹性容器实例 VCI用户指南VCI Agent Sandbox数据持久化
复制全文
下载 pdf数据持久化
文档反馈
问问助手本文主要介绍 VCI Agent Sandbox 中实现沙箱数据持久化的方法。
系统盘
系统盘的快照，引入 SandboxSnapShot（Namespaced）与 SandboxSnapShotClass（Cluster-scoped），用于统一抽象 Sandbox 的快照能力。
- SandboxSnapShot：表示对特定 Sandbox 执行一次快照并记录快照状态、ID、保留时间等信息。
- SandboxSnapShotClass：描述底层生成快照参数与默认删除策略。
说明
系统盘快照制作时间，与系统盘中所产生的临时数据大小相关，应避免在系统盘快照制作完成之前，进行恢复沙箱操作。
SandboxSnapshot
命名空间级别，对特定 Sandbox 执行一次快照并记录快照状态、ID、保留时间等信息。
apiVersion: extensions.agents.x-k8s.io/v1alpha1
kind: SandboxSnapShot
metadata:
name: demo-sandbox-snap-001
namespace: default
spec:
sandboxRef: # 指定要进行快照的 Sandbox Reference。
apiVersion: agents.x-k8s.io/v1alpha1
kind: Sandbox
name: demo-sandbox
namespace: default
snapshotClassName: vci-provider-class # 使用的快照存储服务类型。非必填参数。
deletionPolicy: Delete # 快照删除策略，参数值说明：Delete（删除 SandboxSnapshot 时，删除底层快照）/ Retain（删除 SandboxSnapshot 时，保留底层快照）。
retentionDays: 15 # 快照保留时长，默认 15 天。
status:
phase: Completed # 快照状态。参数值说明：Pending（尚未提交创建快照任务）/ InProgress（快照创建中）/ Completed（快照创建完成）/ Failed（快照创建失败）。
snapshotID: vci-snap-123456 # 快照 ID。
sizeBytes: 40GB # 快照大小。
creationTime: "2025-12-04 12:00:00" # 快照创建时间。
expirationTime: "2025-12-19 12:00:00" # 快照过期时间。
conditions: # 记录快照状态，表示当前快照是否 Ready 以及记录快照错误信息。
- type: Ready
status: "True"
lastTransitionTime: "2025-12-04T12:00:10Z"
reason: SnapshotCreated
message: "Snapshot successfully created by VCI provider"
- type: Error
status: "False"
SandboxSnapShotClass
描述创建快照的相关参数、快照删除策略等。
apiVersion: extensions.agents.x-k8s.io/v1alpha1
kind: SandboxSnapShotClass
metadata:
name: vci-snapshot-class
spec:
driver: sandbox.agent.io/vci # 快照后端 Provider。目前仅支持 vci 一种类型 Provider。
deletionPolicy: Delete # 快照删除策略，参数值说明：Delete（删除 SandboxSnapshot 时，删除底层快照）/ Retain（删除 SandboxSnapshot 时，保留底层快照）。
retentionDays: 20
数据盘
数据盘支持挂载分布式文件系统（NAS），用户多沙箱之间共享数据。
沙箱生命周期内生产的数据可以存储到持久化存储 ( PV & PVC )，当 Pod 删除重建后，仍然可以挂载 PVC 的数据到容器内，Sandbox CRD 定义了 volumeClaimTemplates 模版，其中允许用户设置 Volume 的accessmode、storage size、storageClassName，即类似 Statfulset CRD 的使用方式。
数据盘数据保存策略由 Volume 的保存策略决定：
- Retain: PVC 释放后，PV 保持在 Released 状态，不自动删除或回收。
- Delete: PVC 释放后，自动删除 PV 及其底层存储资源。
- Recycle: PVC 释放后，将卷回收到未绑定 PV 池中，可被其他 PVC 重新使用。
apiVersion: agents.x-k8s.io/v1alpha1
kind: Sandbox
metadata:
name: demo-sandbox
spec:
replicas: 1
volumeClaimTemplates:
- metadata:
name: nginx-data
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: 5Gi
storageClassName: sandbox-nfs
podTemplate:
spec:
tolerations:
- key: "vci.vke.volcengine.com/node-type"
operator: "Exists"
effect: "NoSchedule"
containers:
- name: ubuntu-sshd
image: vke-qa-cn-beijing.cr.volces.com/qa/ubuntu-sshd:12.04
command: ["/usr/sbin/sshd", "-D"]
ports:
- containerPort: 22
volumeMounts:
- name: nginx-data
mountPath: /usr/share/nginx/html
最近更新时间：2026.04.09 15:42:07
这个页面对您有帮助吗？
有用
有用
无用
无用