容器与云原生 / 系统课时

理解 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 版本支持该能力。

AccessMode 与 VolumeMode 的两条约束轴

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 不会按预期绑定。

yaml
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 的模式与访问约束。

bash
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

预期输出

text
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 而不核对后端能力,是存储绑定故障最常见的起点之一。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解 AccessMode 与 VolumeMode

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

登录哪都通