静态卷供应PV参数说明

表 1 静态卷供应参数

参数

说明

必选参数

默认值

备注

metadata.name

自定义的PV对象名称。

是

-

以Kubernetes v1.22.1为例，支持数字、小写字母、中划线（-）和点（.）的组合，并且必须以字母数字开头和结尾。

spec.volumeMode

卷模式。可选参数。 当使用LUN类型的卷时，支持配置以下类型：

  • Filesystem：本地文件系统。
  • Block：裸设备。

否

Filesystem

该参数在挂载PV时生效，默认为Filesystem。

  • Filesystem表示在容器通过一个本地文件系统访问PV，本地文件系统类型为指定StorageClass中的fsType字段指定。
  • Block表示使用裸卷的方式访问访问PV。

spec.storageClassName

StorageClass对象名称。必选参数。

是

-

此处须设置为空字符串（即输入""）。

spec.accessModes

指定卷访问模式。

  • RWO（ReadWriteOnce）：卷可以被一个节点以读写方式挂载。 该模式也允许运行在同一节点上的多个 Pod 访问卷。
  • ROX（ReadOnlyMany）：卷可以被多个节点以只读方式挂载。
  • RWX（ReadWriteMany）：卷可以被多个节点以读写方式挂载。
  • RWOP（ReadWriteOncePod）：卷只能被单个 Pod 以读写方式挂载。该特性需要 Kubernetes 1.22 以上版本。

是

ReadWriteOnce

  • RWO/ROX/RWOP：所有类型卷均支持，RWOP需Kubernetes 1.22版本以上支持。请参考开启ReadWriteOncePod功能门章节，检查您的Kubernetes集群是否开启该特性。
  • RWX支持情况如下：

spec.csi.driver

CSI驱动名称。

是

csi.huawei.com

该字段需要指定为安装华为CSI时设置的驱动名称。

spec.csi.volumeHandle

存储资源的唯一标志。必选参数。

格式为：<backendName>.<volume-name>

是

-

该参数值由以下两部分构成：

  • <backendName>：该卷所在的后端名称，可使用如下命令获取配置的后端信息：

    oceanctl get backend

  • <volume-name>：存储上资源（LUN/文件系统）的名称，可通过DeviceManager查看。

spec.csi.fsType

指定主机文件系统类型。可选参数。支持类型为：

  • ext2
  • ext3
  • ext4
  • xfs

否

-

如果不设置，默认为ext4。仅当volumeMode配置为“Filesystem”时生效。

spec.capacity.storage

指定卷大小。

是

100Gi

请确保与存储上对应资源的容量保持一致。Kubernetes并不会调用CSI检查此字段值的正确性，所以在PV容量与存储上对应资源的容量不一致也能被成功创建。

spec.mountOptions.nfsvers

主机侧NFS挂载选项。支持如下挂载选项：

nfsvers：挂载NFS时的协议版本。支持配置的参数值为“3”，“4”，“4.0”，“4.1”和“4.2”。

否

-

在主机执行mount命令时-o参数后的可选选项。列表格式。

指定NFS版本挂载时，当前支持NFS 3/4.0/4.1/4.2协议（需存储设备支持且开启）。当配置参数为nfsvers=4时，因为操作系统配置的不同，实际挂载可能为NFS 4的最高版本协议，如4.2，当需要使用4.0协议时，建议配置nfsvers=4.0。

spec.mountOptions.acl

DPC命名空间支持ACL功能。DPC客户端支持POSIX ACL、NFSv4 ACL、NT ACL的鉴权行为。

否

-

acl、aclonlyposix、cnflush、cflush参数描述仅供参考，详细参数说明请参考《OceanStor Pacific系列 产品文档》 > 配置 > 文件服务基础业务配置指南 > 配置基础业务（DPC场景） > 客户端访问DPC共享 > 步骤2。

spec.mountOptions.aclonlyposix

DPC命名空间支持POSIX ACL功能，DPC客户端支持POSIX ACL的鉴权行为。

支持POSIX ACL的协议有：DPC、NFSv3、HDFS。如使用NFSv4 ACL或NT ACL，会导致DPC客户端无法识别该类型的ACL，从而导致该类型的ACL不会生效。

否

-

aclonlyposix与acl参数同时使用时，仅acl参数生效，即命名空间支持ACL功能。

spec.mountOptions.cnflush

异步刷盘模式，即关闭命名空间下的文件时不会立即刷盘。

否

-

异步刷盘模式，当文件关闭时不会同步将Cache的数据持久化到存储介质中，而是通过Cache异步刷盘的方式将数据写入存储介质，Cache的后台刷盘将在写业务完成后根据刷盘周期定时刷盘。在多客户端场景下，对同一文件进行并行操作，文件Size的更新会受刷盘周期的影响，即当刷盘动作完成后才会更新文件的Size，更新通常会在数秒内完成。同步I/O不受刷盘周期影响。

spec.mountOptions.cflush

同步刷盘模式，即关闭命名空间下的文件时立即刷盘。

否

-

默认使用同步刷盘模式。