纳管卷供应StorageClass参数说明

存储类（StorageClass）为管理员提供了描述存储 “类” 的方法。 不同的类型可能会映射到一组不同的能力定义。Kubernetes集群用户可基于StorageClass进行动态卷制备。

StorageClass支持配置如下参数信息。

使用SAN存储时可参考示例文件/examples/sc-lun.yaml，使用NAS存储时可参考示例文件/examples/sc-fs.yaml。

表 1 StorageClass配置参数说明

参数

说明

必选参数

默认值

备注

metadata.name

自定义的StorageClass对象名称。

是

-

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

provisioner

制备器名称。

是

csi.huawei.com

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

取值和values.yaml文件中driverName一致。

reclaimPolicy

回收策略。支持如下类型：

  • Delete：自动回收资源。
  • Retain：手动回收资源。

是

-

  • Delete：删除PV/PVC时会关联删除存储上的资源。
  • Retain：删除PV/PVC时不会删除存储上的资源。

allowVolumeExpansion

是否允许卷扩展。参数设置为true 时，使用该StorageClass的PV可以进行扩容操作。

否

false

此功能仅可用于扩容PV，不能用于缩容PV。

扩容PV功能在Kubernetes 1.14 (alpha)后才支持。

parameters.backend

待创建资源所在的后端名称。

否

-

如果不设置，华为CSI随机选择一个满足容量要求的后端创建资源。

建议指定后端，确保创建的资源在预期的后端上。

parameters.volumeType

待创建卷类型。支持如下类型：

  • lun：存储侧发放的资源是LUN。
  • fs：存储侧发放的资源是文件系统。

是

-

  • 使用NAS存储时，必须配置为fs。
  • 使用SAN存储时，必须配置为lun。

parameters.fsType

主机文件系统类型。支持类型为：

  • ext2
  • ext3
  • ext4
  • xfs

否

ext4

仅当StorageClass的volumeType设置为“lun”，且PVC的volumeMode配置为“Filesystem”时生效。

parameters.applicationType

后端为OceanStor Dorado存储时，指定创建LUN/NAS时的应用类型名称。

说明：

若卷纳管前已配置应用类型，applicationType必须与已配置的应用类型保持一致。

否

-

  • “volumeType”为“lun”时，在DeviceManager管理界面，选择“服务 > 块服务 > LUN组 > LUN > 创建 > 应用类型”，获取应用类型名称。
  • “volumeType”为“fs”时，在DeviceManager管理界面，选择“服务 > 文件服务 > 文件系统 > 创建 > 应用类型”，获取应用类型名称。

parameters.fsPermission

挂载到容器内的目录权限。

否

-

配置格式参考Linux权限设置，如“777”、“755”等。

当volumeType为lun时，支持配置该字段。

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协议时，建议配置nfsver:ws=4.0。

mountOptions.acl

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

否

-

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

mountOptions.aclonlyposix

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

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

否

-

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

mountOptions.cnflush

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

否

-

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

mountOptions.cflush

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

否

-

默认使用同步刷盘模式。

mountOptions.sec

用于指定Kerberos 5协议挂载NFS文件系统。

否

-

  • 使用Kerberos 5协议时，请配置krb5。
  • 使用Kerberos 5i协议时，请配置krb5i。
  • 使用Kerberos 5p协议时，请配置krb5p。
  • Kerberos仅支持NFSv4.0或NFSv4.1

mountOptions.proto

指定NFS挂载时使用的传输协议。

支持配置参数值为：“rdma”。

否

-

  • 确保存储系统已启用NFS over RDMA。
  • 支持OceanStor Dorado 6.1.7及以上的NAS存储

mountOptions.port

指定NFS挂载时使用的协议端口。

条件必选

-

传输协议方式使用“rdma”时，请设置为：20049。

mountOptions.discard

挂载文件系统时自动触发Trim/Discard操作。该操作会通知块设备释放未使用的块。

否

-

支持xfs、ext4文件系统。