容器与云原生 / 系统课时
使用卷克隆复制数据
使用卷克隆复制数据
卷克隆适合从现有 PVC 快速得到一份可独立使用的数据副本。本课完成一次基于 dataSource 的 CSI 克隆,并把命名空间、容量、VolumeMode、StorageClass、绑定模式与驱动能力这些约束逐一验证清楚。
学习目标
- 能写出以现有 PVC 为
dataSource的目标 PVC。 - 能判断命名空间、容量、
VolumeMode与 StorageClass 是否满足克隆条件。 - 能从 PVC 事件区分引用或规格错误与 CSI 驱动、后端能力问题。
先把克隆约束查清
PVC 克隆不是 Kubernetes 在节点上复制文件,而是 external-provisioner 把源卷作为 VolumeContentSource 交给 CSI Controller,再由存储后端创建新卷。源 PVC 必须已经 Bound;使用常规 dataSource 时,源与目标 PVC 必须位于同一命名空间,目标请求容量不能小于源容量,并且两端 volumeMode 必须一致。
目标 storageClassName 可以与源 PVC 不同,但目标 StorageClass 的 provisioner 必须能识别源卷并支持克隆;实际能否跨存储池或参数组合克隆取决于 CSI 驱动和后端。若业务仍在持续写入源卷,还要按应用与驱动要求处理一致性,避免得到逻辑上不一致的副本。

先检查源 PVC、源 PV 的 CSI 驱动和目标 StorageClass。下面假设源卷为 app/mysql-data,目标使用 fast-csi,并以 Immediate 绑定模式演示。
SOURCE_PV=$(kubectl -n app get pvc mysql-data -o jsonpath='{.spec.volumeName}')
kubectl -n app get pvc mysql-data -o jsonpath='{.status.phase}{"\n"}{.spec.storageClassName}{"\n"}{.spec.volumeMode}{"\n"}{.spec.resources.requests.storage}{"\n"}'
kubectl get pv "$SOURCE_PV" -o jsonpath='{.spec.csi.driver}{"\n"}'
kubectl get storageclass fast-csi -o jsonpath='{.provisioner}{"\n"}{.volumeBindingMode}{"\n"}'预期输出
Bound
fast-csi
Filesystem
20Gi
<CSI_DRIVER>
<CSI_DRIVER>
Immediate这里必须能正确读到 .spec.storageClassName。两个 <CSI_DRIVER> 在本示例中应一致,分别代表源 PV 的 CSI 驱动与目标 StorageClass 的 provisioner。若绑定模式是 WaitForFirstConsumer,目标 PVC 可能要等到消费它的 Pod 被调度后才开始供给,不能直接把长时间 Pending 判断为克隆失败。
创建并等待克隆 PVC
相较普通 PVC,克隆额外需要 dataSource.kind 与 dataSource.name 指向同命名空间的源 PVC。PVC 属于 core API,因此这里不填写 apiGroup。
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: mysql-data-clone
namespace: app
spec:
accessModes:
- ReadWriteOnce
storageClassName: fast-csi
volumeMode: Filesystem
resources:
requests:
storage: 20Gi
dataSource:
kind: PersistentVolumeClaim
name: mysql-data保存为 pvc-clone.yaml 后创建目标 PVC,并等待动态供给完成。本示例已确认 fast-csi 使用 Immediate;若实际为 WaitForFirstConsumer,应先创建消费该 PVC 的 Pod,再观察绑定过程。
kubectl apply -f pvc-clone.yaml
kubectl -n app wait --for=jsonpath='{.status.phase}'=Bound pvc/mysql-data-clone --timeout=120s
kubectl -n app get pvc mysql-data-clone -o jsonpath='{.status.phase}{"\n"}{.spec.volumeName}{"\n"}'预期输出
persistentvolumeclaim/mysql-data-clone created
persistentvolumeclaim/mysql-data-clone condition met
Bound
<CLONE_PV><CLONE_PV> 是动态生成的 PV 名称。不同后端完成克隆的时间差异很大,120 秒只是实验超时,不应直接当成生产 SLO。
确认得到的是独立副本
克隆 PVC 进入 Bound 只说明新卷已经供给并绑定,还应确认源与目标绑定到不同 PV。克隆完成后,两者是独立卷,后续修改或删除其中一个不会自动同步到另一个。
kubectl -n app get pvc mysql-data mysql-data-clone -o custom-columns='PVC:.metadata.name,PHASE:.status.phase,PV:.spec.volumeName'预期输出
PVC PHASE PV
mysql-data Bound <SOURCE_PV>
mysql-data-clone Bound <CLONE_PV><SOURCE_PV> 与 <CLONE_PV> 应不同。若要证明业务数据正确,还应把克隆卷挂载到隔离的验证 Pod 或测试实例执行应用级校验;不要把“PVC 已 Bound”误当成“数据一定可用”。
Pending 时按事件定位
目标 PVC 长时间 Pending 时,先查看 Events;这一步能最快区分对象引用、规格约束和供给侧错误。
kubectl -n app describe pvc mysql-data-clone预期结果
Events:
<EVENTS><EVENTS> 的实际内容取决于失败原因。若提示源对象找不到,优先检查命名空间与 dataSource.name;若目标容量小于源卷或 volumeMode 不一致,应修正规格并重新创建目标 PVC。若事件来自 external-provisioner,则继续核对目标 StorageClass 的 provisioner、源 PV 的 CSI 驱动、驱动是否支持 CLONE_VOLUME,以及后端是否允许从该源卷创建副本。卷克隆解决的是快速复制,不等价于跨故障域备份;需要长期保护或时间点恢复时,应使用快照或备份流程。