容器与云原生 / 系统课时
理解 AccessMode 与 VolumeMode
理解 AccessMode 与 VolumeMode
创建 PVC 时,accessModes 和 volumeMode 共同决定“谁能使用这个卷”以及“容器以什么形式看到它”。本节把四种访问模式与 Filesystem、Block 两种呈现方式拆开理解,并用一个可验证的 CSI 示例说明它们如何约束工作负载。
学习目标
- 区分 RWO、ROX、RWX、RWOP 的节点或 Pod 级访问边界。
- 判断 Filesystem 与 Block 对容器挂载方式和应用职责的影响。
- 能根据应用并发模型与 CSI 驱动能力选择正确组合。
AccessMode 决定访问拓扑
accessModes 描述 PV/PVC 期望的访问能力,并参与卷的匹配、供给和使用约束。它不是 Linux 文件权限,也不能只看名称猜“能启动几个 Pod”。
| 模式 | 完整名称 | 核心约束 |
|---|---|---|
| RWO | ReadWriteOnce | 可由一个节点以读写方式挂载;同一节点上的多个 Pod 仍可能同时访问 |
| ROX | ReadOnlyMany | 可由多个节点以只读方式挂载 |
| RWX | ReadWriteMany | 可由多个节点以读写方式挂载 |
| RWOP | ReadWriteOncePod | 整个集群只允许一个 Pod以读写方式使用该卷 |
最容易混淆的是 RWO 与 RWOP。RWO 限制的是节点,不是 Pod;如果应用要求严格单写者,RWO 不能替代 RWOP。RWOP 仅适用于 CSI 卷,在 Kubernetes v1.29 已稳定;实际使用还要确认 CSI 驱动及其 sidecar 版本支持该能力。

VolumeMode 决定目录还是原始设备
volumeMode: Filesystem 是默认值。容器通过 volumeMounts 把卷挂到目录;如果后端是未格式化的块设备,挂载流程会按驱动和文件系统配置完成格式化后再提供目录语义。绝大多数普通应用都应从 Filesystem 开始。
volumeMode: Block 则跳过文件系统层,把原始块设备直接暴露给容器,Pod 需要使用 volumeDevices 和 devicePath。数据库或存储引擎只有在明确能够管理原始设备时才应选择 Block。PV 与 PVC 的 volumeMode 必须匹配,否则不会形成正常绑定。
用一个 Pod 对比两种 VolumeMode
下面的配置同时申请一个 Filesystem 卷和一个 raw Block 卷。先把 <STORAGE_CLASS> 替换为集群中同时支持动态供给、raw block 与相应 AccessMode 的 CSI StorageClass;若驱动不支持 RWOP 或 Block,第二个 PVC 不会按预期绑定。
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: fs-data
spec:
storageClassName: <STORAGE_CLASS>
accessModes:
- ReadWriteOnce
volumeMode: Filesystem
resources:
requests:
storage: 1Gi
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: raw-data
spec:
storageClassName: <STORAGE_CLASS>
accessModes:
- ReadWriteOncePod
volumeMode: Block
resources:
requests:
storage: 1Gi
---
apiVersion: v1
kind: Pod
metadata:
name: storage-mode-demo
spec:
restartPolicy: Never
containers:
- name: inspector
image: busybox:1.36
command: ["sh", "-c", "df -h /data; ls -l /dev/raw-data; sleep 3600"]
volumeMounts:
- name: fs
mountPath: /data
volumeDevices:
- name: raw
devicePath: /dev/raw-data
volumes:
- name: fs
persistentVolumeClaim:
claimName: fs-data
- name: raw
persistentVolumeClaim:
claimName: raw-data把内容保存为 storage-mode-demo.yaml 后应用,并直接查看 PVC 的模式与访问约束。
kubectl apply -f storage-mode-demo.yaml
kubectl get pvc fs-data raw-data -o custom-columns=NAME:.metadata.name,STATUS:.status.phase,MODE:.spec.volumeMode,ACCESS:.spec.accessModes[0],VOLUME:.spec.volumeName
kubectl get pod storage-mode-demo -o custom-columns=NAME:.metadata.name,PHASE:.status.phase预期输出
persistentvolumeclaim/fs-data created
persistentvolumeclaim/raw-data created
pod/storage-mode-demo created
NAME STATUS MODE ACCESS VOLUME
fs-data Bound Filesystem ReadWriteOnce <PV_NAME>
raw-data Bound Block ReadWriteOncePod <PV_NAME>
NAME PHASE
storage-mode-demo Running<PV_NAME> 由动态供给器生成,实际值不同。如果 raw-data 停在 Pending,应先检查 CSI 驱动是否支持 raw block、RWOP 以及当前 StorageClass,而不是修改 Pod 调度参数。
选择组合时先从应用约束反推
普通单副本有状态应用通常使用 Filesystem + RWO;需要真正的集群级单写者时优先考虑 Filesystem 或 Block + RWOP;多个节点必须同时写同一文件系统时需要 RWX 且后端本身具备共享写能力;只有能直接管理块设备的应用才选择 Block。
最终选择必须同时满足三层条件:应用的并发语义、Kubernetes 的 AccessMode/VolumeMode 规则,以及 CSI 驱动和底层存储的实际能力。只看 PVC YAML 而不核对后端能力,是存储绑定故障最常见的起点之一。