云原生CLI【免费下载链接】openebsA popular widely deployed Open Source Container Native Storage platform for Stateful Persistent Applications on Kubernetes.项目地址https://gitcode.com/gh_mirrors/op/openebs点击查看免费下载导读本文以 OpenEBS LocalPV-LVM 的 VolumeMode 设计文档 为核心系统讲解 Kubernetes 持久化卷的两种 volumeModeFilesystem与Block在 LocalPV-LVM CSI 驱动中的完整工作流。文章覆盖从 Kubelet 发起NodePublishVolumegRPC 请求、CSI 驱动按访问类型执行格式化/挂载或 bind mount到用户在 PVC 中通过spec.volumeMode声明所需模式、并通过测试验证卷可用性的全过程。读完本文你将理解 LocalPV-LVM 两种卷模式背后的实现机理能够正确编写 raw block 与 filesystem 模式的 PVC 清单并掌握与 fsType、mountOptions、accessModes、卷扩容等兄弟特性之间的协作关系。背景Kubernetes 的两种卷模式Kubernetes 为 PersistentVolumePV与 PersistentVolumeClaimPVC定义了两种卷模式VolumeModeFilesystem文件系统模式卷以文件系统形式呈现给 Pod应用看到的是一个可挂载的目录。这是最常用的模式Kubelet 将卷挂载到 Pod 的指定路径后应用通过常规文件读写访问数据。Block原始块模式Raw Block卷以原始块设备的形式呈现给 Pod应用直接访问底层块设备绕过文件系统层。这适用于数据库、虚拟机镜像等需要自行管理存储布局、追求更低延迟与更可控 I/O 的工作负载。这一设定对 LocalPV-LVM 同样适用LVM 卷本身是底层块设备Logical Volume既可以格式化后以文件系统模式挂载给应用也可以直接以块设备形式暴露给应用。两种模式在应用挂载阶段由 CSI 驱动根据请求中的 volume capabilities 区分处理这正是 volume_mode.md 设计的核心。实现细节NodePublishVolume阶段的模式分发当 Pod 调度到某个节点时Kubelet 会识别负责挂载该卷的 CSI 驱动并向其发起NodePublishVolumegRPC 请求。Volume Mode 在这一阶段才真正生效——Kubelet 将卷能力volume capabilities其中包含卷访问类型作为请求的 payload 一并发送给驱动。LocalPV-LVM CSI 驱动根据 volume capabilities 中的访问类型执行两套截然不同的操作访问类型为 mountFilesystem 模式驱动检查目标 Logical Volume 是否已被格式化如果尚未格式化则使用用户指定的文件系统fsType默认为ext4对其进行格式化将已格式化的卷挂载mount到给定的目标路径target path即应用挂载点。访问类型为 blockRaw Block 模式驱动不会对卷做任何格式化驱动在给定的目标路径处创建一个文件通常是/var/lib/kubelet/plugins/.../vol-data-xxx形式的块设备入口文件将底层 LVM 设备以bind mount方式挂载到该文件路径上使 Pod 内可以直接访问原始块设备。成功返回无论哪种模式只要上述操作成功完成驱动即向NodePublishVolumegRPC 请求返回成功响应Kubelet 随后完成 Pod 的启动流程。从仓库文档脉络看这一流程与 fsType 参数设计 和 mountOptions 参数设计 是同一套NodePublishVolume机制的不同侧面驱动在请求中读取 fsType、volume mode、mount options 等信息Filesystem 模式下用 Kubernetes mount-utils 库完成格式化与挂载Block 模式则跳过格式化直接 bind mount 设备。使用细节在 PVC 中声明卷模式用户或管理员可以在 PVC 的spec.volumeMode字段中配置所需的卷模式。以下清单来自 volume_mode.md声明了一个使用openebs-lvmStorageClass、以Filesystem 模式挂载 4Gi 卷的 PVCkind: PersistentVolumeClaim apiVersion: v1 metadata: name: csi-lvmpv spec: accessModes: - ReadWriteOnce storageClassName: openebs-lvm volumeMode: Filesystem ## Specifies in which mode volume should be attached to pod resources: requests: storage: 4Gi要点说明volumeMode取值只有两种Filesystem与Block。不显式声明时默认值为Filesystem。storageClassName: openebs-lvm必须指向 LocalPV-LVM 提供的 StorageClassprovisioner 为local.csi.openebs.io、参数storage: lvm详见 storage_class.md。accessModes: ReadWriteOnce是 LocalPV-LVM 唯一支持的访问模式因为 LVM 卷在任意时刻最多只能在一个节点上可用详见 access_mode.md。注意volumeMode 与 accessModes 是两个相互独立的维度前者描述卷的呈现形式文件系统 vs 裸块设备后者描述卷的节点访问能力单节点读写等二者需在 PVC 中分别声明。Raw Block 模式的 PVC 示例若要创建 Block 模式卷将volumeMode改为Block即可kind: PersistentVolumeClaim apiVersion: v1 metadata: name: csi-lvmpv-block spec: accessModes: - ReadWriteOnce storageClassName: openebs-lvm volumeMode: Block resources: requests: storage: 4Gi创建成功后Pod 中通过volumeDevices与devicePath引用该块设备应用即可直接读写底层 LVM 设备。与 fsType、mountOptions 的协作关系volumeMode 并非孤立的配置项它与 StorageClass 中的fsType、mountOptions参数紧密配合fsTypeKubernetes 在 StorageClass 的parameters中注册了fsType键也支持csi.storage.k8s.io/fstype用于指定文件系统类型未指定时默认ext4LocalPV-LVM 支持ext[2|3|4]、xfs、btrfs。它只在Filesystem 模式下生效——格式化动作仅发生在访问类型为 mount 的分支中Block 模式完全忽略 fsType。参考 fs_type.mdapiVersion: storage.k8s.io/v1 kind: StorageClass metadata: name: openebs-lvm allowVolumeExpansion: true provisioner: local.csi.openebs.io parameters: storage: lvm vgpattern: lvmvg.* fsType: xfsmountOptionsStorageClass 顶层的mountOptions字段指定挂载选项同样只在 Filesystem 模式挂载阶段被消费。K8s 与 CSI 驱动均不校验其合法性非法选项会导致挂载失败原因可查看应用 Pod 的 describe 输出。参考 mount_options.mdapiVersion: storage.k8s.io/v1 kind: StorageClass metadata: name: openebs-lvmpv-xfs provisioner: local.csi.openebs.io allowVolumeExpansion: true parameters: storage: lvm vgpattern: ^lvmvg$ fsType: ext4 mountOptions: - barrier0 - commit10 - datajournal由此可以总结出完整的分发逻辑volumeMode: Filesystem时走格式化按 fsType mount按 mountOptions链路volumeMode: Block时两条链路全部跳过直接 bind mount 设备。Raw Block 卷的扩容能力volumeMode 还影响后续的容量管理能力。LocalPV-LVM 支持卷扩容allowVolumeExpansion: true而 raw block 卷同样可以扩容——resize_workflow.md 的测试计划明确包含对 raw block 卷执行扩容并从应用内部验证其容量已更新的用例说明 Block 模式卷与 Filesystem 模式卷在扩容路径上是一致受支持的。测试计划与验证方法volume_mode.md 给出的测试计划包含两条核心用例可作为日常验证两种模式是否正常工作的操作清单Filesystem 模式创建一个 filesystem 模式的卷并部署应用验证卷已按用户指定的文件系统完成格式化可通过kubectl exec进入 Pod 后执行mount或df -T查看文件系统类型确认。Raw Block 模式创建一个 Block 模式卷并部署应用从应用 Pod 内部验证块卷的可访问性例如通过volumeDevices暴露的/dev/设备路径执行读写或运行fio等块 I/O 工具进行实际写入验证。此外resize_workflow.md 与 volume-attributes-class.md 的后续演进设计表明volumeMode: Block与volumeMode: Filesystem两类 PVC 都已被纳入容量监控与 I/O 限流基于 cgroup v2 的 io.max等高级能力的作用范围验证场景中会同时覆盖两种模式。注意事项与常见误区K8s 不做校验Kubernetes 与 LocalPV-LVM CSI 驱动都不会对volumeMode之外的关联参数如 fsType、mountOptions做语义校验错误配置的结果是挂载失败需要在 Pod 事件与 describe 输出中排查这与 storage_class.md 中StorageClass 不可用时 PVC 将停留在 Pending 状态的提示同理。Block 模式无文件系统在 Block 模式下不要期望看到文件系统相关行为应用必须自行处理存储布局如数据库初始化数据文件、文件系统工具如mkfs由应用自己负责这正是选择 Block 模式通常是为了数据库/虚拟机场景的原因。两种模式共用同一 StorageClassvolumeMode是 PVC 属性而非 StorageClass 属性同一个openebs-lvmStorageClass 可以同时服务 Filesystem 与 Block 两种 PVCKubelet 与 CSI 驱动按每卷的 volume capabilities 自动分发。总结LocalPV-LVM 通过 CSINodePublishVolume阶段的 volume capabilities 分发完整支持了 Kubernetes 的Filesystem与Block两种卷模式前者走按 fsType 格式化 mount链路后者走创建目标文件 bind mount 设备链路。用户在 PVC 中仅需一行volumeMode声明即可切换卷的呈现形式且该能力与 LocalPV-LVM 的 StorageClass 体系、扩容、快照、I/O 限流等特性相互兼容。相关设计文档均以状态Implemented标记说明该机制已在当前仓库中落地实现。赞分享云原生CLI【免费下载链接】openebsA popular widely deployed Open Source Container Native Storage platform for Stateful Persistent Applications on Kubernetes.项目地址https://gitcode.com/gh_mirrors/op/openebs点击查看免费下载相关推荐OpenEBS LocalPV-LVM fsType 参数全解析为 LVM 卷指定文件系统格式OpenEBS LocalPV LVM fsType 参数全解析为 LVM 卷指定文件系统格式 导读 本文围绕 OpenEBS LocalPV LVM 引擎的云原生CLIEMQX 出站 MQTT 连接 TCP 调优为 MQTT Bridge Connector 与 Cluster Link 配置 tcp_optsEMQX 出站 MQTT 连接 TCP 调优为 MQTT Bridge Connector 与 Cluster Link 配置 tcp_opts 本文基于 E云原生CLINodeos 区块重放Replay完整指南从 blocks.log 与快照文件恢复链状态Nodeos 区块重放Replay完整指南从 blocks.log 与快照文件恢复链状态 nodeos EOSIO 核心节点程序提供了多种从本地数据重云原生CLI上一篇Wasp 运行环境配置访问指南在 React 前端与 Express 后端中安全读取 frontendUrl 与 apiUrl下一篇Agent Zero 配置全指南settings.json、LLM 角色体系与 A0_SET_ 环境变量覆盖机制创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考