容器与云原生 / 系统课时

在线扩容 PVC 与文件系统

在线扩容 PVC 与文件系统

PVC 扩容不是把容量字段改大就结束。本课沿一条可验证的链路完成在线扩容:先确认 StorageClass 和 CSI 驱动允许扩容,再提高 PVC 请求容量,最后核对后端卷、PVC 状态与 Pod 内文件系统是否都已收敛到新容量。

学习目标

  • 判断 PVC 是否满足扩容前提,并说明为什么不能直接修改 PV 容量。
  • 解释 allowVolumeExpansion、ControllerExpandVolume 与 NodeExpandVolume 在典型 CSI 扩容链路中的职责。
  • 使用 kubectl 验证 PVC 请求容量、状态容量与挂载文件系统是否一致。

先确认扩容前提

Kubernetes 允许增大 PVC 的存储请求,但不能通过 PVC 扩容机制缩小卷。PVC 所属 StorageClass 必须设置 allowVolumeExpansion: true,对应 CSI 驱动和存储后端也必须支持扩容。不要直接修改 PV 的 spec.capacity:这不会代替实际的后端卷扩容,还可能让控制面认为目标容量已经满足,从而跳过正常扩容流程。

以下示例假定命名空间 storage-lab 中已有 Bound 状态的 PVC data-demo。先读取它的 StorageClass、请求容量、状态容量和卷模式:

bash
NS=storage-lab
PVC=data-demo
SC=$(kubectl get pvc "$PVC" -n "$NS" -o jsonpath='{.spec.storageClassName}')

kubectl get storageclass "$SC" \
  -o custom-columns=NAME:.metadata.name,PROVISIONER:.provisioner,EXPAND:.allowVolumeExpansion
kubectl get pvc "$PVC" -n "$NS" \
  -o custom-columns=NAME:.metadata.name,REQUEST:.spec.resources.requests.storage,CAPACITY:.status.capacity.storage,MODE:.spec.volumeMode

预期输出

text
NAME      PROVISIONER         EXPAND
<VALUE>   <CSI_PROVISIONER>   true
NAME        REQUEST   CAPACITY   MODE
data-demo   10Gi      10Gi       Filesystem

实际 provisioner、原始容量和 volumeMode 可能不同。如果 EXPAND 不是 true,不要继续修改 PVC;应先确认是否有支持扩容的 StorageClass,并通过 CSI 驱动文档或存储平台能力说明确认该驱动与后端支持卷扩容。

看懂控制面与节点扩容顺序

在典型的 CSI 块存储加文件系统场景中,PVC 请求容量增大后,external-resizer 会观察到扩容需求,并在驱动支持控制器侧扩容时调用 ControllerExpandVolume 扩大后端卷。之后 kubelet 在卷所在节点协调节点侧扩容;如果驱动要求节点扩容,则由 CSI node plugin 处理 NodeExpandVolume,让节点使用新的设备容量,并在需要时完成文件系统扩展。

PVC 在线扩容从请求容量到文件系统生效的链路

这不是所有 CSI 卷都固定经历的两段式流程。Raw Block 卷没有文件系统扩展阶段;不同驱动是否需要 ControllerExpandVolume、NodeExpandVolume,以及能否在卷被 Pod 持续使用时在线完成扩容,都取决于驱动能力、存储后端和文件系统。若驱动只支持离线扩容,应按其要求停止使用或解除挂载后再扩容。

发起扩容并观察收敛

把示例 PVC 从 10Gi 调整到 20Gi。这里修改的是 PVC 的请求值,而不是 PV:

bash
kubectl patch pvc data-demo -n storage-lab --type merge \
  -p '{"spec":{"resources":{"requests":{"storage":"20Gi"}}}}'

预期输出

text
persistentvolumeclaim/data-demo patched

扩容是异步过程。稍后比较请求容量与状态容量:

bash
kubectl get pvc data-demo -n storage-lab \
  -o custom-columns=NAME:.metadata.name,REQUEST:.spec.resources.requests.storage,CAPACITY:.status.capacity.storage,PHASE:.status.phase

预期输出

text
NAME        REQUEST   CAPACITY   PHASE
data-demo   20Gi      20Gi       Bound

刚修改后如果 REQUEST 已是 20Gi,而 CAPACITY 仍是旧值,并不必然代表失败,只说明扩容尚未收敛。此时执行 kubectl describe pvc data-demo -n storage-lab,重点查看 Events 与 Conditions,可以判断请求是否卡在控制器侧扩容、等待节点侧文件系统扩展,或被存储后端拒绝。

验证文件系统真的变大

PVC 的 status.capacity 收敛后,对 Filesystem 卷还应从实际挂载它的 Pod 内检查文件系统。下面假定 Pod 名为 app-0,挂载点为 /data:

bash
kubectl exec -n storage-lab app-0 -- df -h /data

预期输出

text
Filesystem      Size  Used     Avail    Use%    Mounted on
<DEVICE>         20G  <VALUE>  <VALUE>  <VALUE> /data

设备名、容量显示方式和可用空间会随驱动、文件系统及已有数据变化。若 PVC 已显示 20Gi,但 Pod 内仍看到旧容量,应继续检查 PVC 事件、kubelet 和 CSI node plugin 日志;这通常说明后端卷已经扩大,但节点侧 NodeExpandVolume 或文件系统扩展尚未完成。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

在线扩容 PVC 与文件系统

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通