Helm values.yaml参数说明

images.huaweiCSIService

huawei-csi镜像。

是

huawei-csi:4.5.0

images.storageBackendSidecar

华为后端管理sidecar镜像。

是

storage-backend-sidecar:4.5.0

images.storageBackendController

华为后端管理控制器镜像。

是

storage-backend-controller:4.5.0

images.huaweiCSIExtender

huawei-csi-extender镜像

否

huawei-csi-extender:4.5.0

images.sidecar.livenessProbe

livenessprobe sidecar镜像。

是

k8s.gcr.io/sig-storage/livenessprobe:v2.5.0

images.sidecar.provisioner

csi-provisioner sidecar镜像。

是

k8s.gcr.io/sig-storage/csi-provisioner:v3.0.0

images.sidecar.attacher

csi-attacher sidecar镜像。

是

k8s.gcr.io/sig-storage/csi-attacher:v3.4.0

images.sidecar.resizer

csi-resizer sidecar镜像。

是

k8s.gcr.io/sig-storage/csi-resizer:v1.4.0

images.sidecar.snapshotter

csi-snapshotter sidecar镜像。

是

k8s.gcr.io/sig-storage/csi-snapshotter:v4.2.1

images.sidecar.snapshotController

snapshot-controller sidecar镜像。

是

k8s.gcr.io/sig-storage/snapshot-controller:v4.2.1

images.sidecar.registrar

csi-node-driver-registrar sidecar镜像。

是

k8s.gcr.io/sig-storage/csi-node-driver-registrar:v2.3.0

controller.controllerCount

huawei-csi-controller组件的副本数

是

1

-

controller.volumeNamePrefix

PV名称的前缀，默认值为pvc，即创建的PV名称为：pvc-<uuid>。前缀必须满足DNS 子域名的命名规则，且PV名称总长度不得超过253个字符。

否

pvc

对应的provisioner参数名称为：--volume-name-prefix。

建议前缀不超过20个字符。

详细配置请参考配置PV名称前缀。

• 对接后端是OceanStor V5 SAN时，建议前缀不超过5个字符。
• 对接后端是OceanStor V5 NAS存储时，前缀只能包含小写字母、'-'，以及数字。
• 对接后端是OceanStor Dorado和OceanStor存储时，前缀只能包含小写字母、'-'，以及数字。
• 对接后端是OceanStor Pacific系列存储时，前缀只能包含字母、数字、“_”、“-”和“.”，且总长度限制为58字符。
• 对接后端是FusionStorage Block时，前缀只能包含字母、数字、“_”和“-”，且总长度限制为58字符。

controller.webhookPort

webhook服务使用的端口。

是

4433

如果存在端口冲突可修改为其他未占用的端口。

controller.snapshot.enabled

是否开启快照特性。

是

true

如果要使用快照相关功能，请开启该特性。

要求Kubernetes版本高于v1.17。

controller.resizer.enabled

是否开启扩容特性。

是

true

要求Kubernetes版本高于v1.16。

controller.nodeSelector

huawei-csi-controller的节点选择器。配置后huawei-csi-controller仅会调度到存在该标签的节点上。

否

-

节点选择器的详细说明请参考：将 Pod 分配给节点

controller.tolerations

huawei-csi-controller的污点容忍。配置后huawei-csi-controller能够容忍节点上存在该污点。

否

-

污点和容忍度的详细说明请参考：污点和容忍度

controller.livenessProbePort

huawei-csi-controller的存活性探针端口，用于健康检查。

是

9808

如果存在端口冲突可修改为其他未占用的端口

controller.csiExtender.volumeModify.enabled

是否开启PVC变更特性。

否

false

如果要PVC变更相关功能，请开启该特性。

controller.csiExtender.volumeModify.retryBaseDelay

PVC变更创建任务失败时的最小重试间隔。

否

5s

建议使用默认值。

controller.csiExtender.volumeModify.retryMaxDelay

PVC变更创建任务失败时的最大重试间隔。

否

5m

建议使用默认值。

controller.csiExtender.volumeModify.reconcileDelay

调协VolumeModifyClaim对象的间隔。

否

1s

建议使用默认值。

node.maxVolumesPerNode

节点可使用的华为CSI发放卷的最大数量。不定义或者配置为0时则认为不限制。

如果创建Pod时，指定 nodeName，则会忽略该配置。

否

100

详细说明请参考：Volume Limits

node.nodeSelector

huawei-csi-node的节点选择器。配置后huawei-csi-node仅会调度到存在该标签的节点上。

否

-

节点选择器的详细说明请参考：将 Pod 分配给节点

node.tolerations

huawei-csi-node的污点容忍。配置后huawei-csi-node能够容忍节点上存在该污点。

否

- key: "node.kubernetes.io/memory-pressure"
  operator: "Exists"
  effect: "NoExecute"
- key: "node.kubernetes.io/disk-pressure"
  operator: "Exists"
  effect: "NoExecute"
- key: "node.kubernetes.io/network-unavailable"
  operator: "Exists"
  effect: "NoExecute"

污点和容忍度的详细说明请参考：污点和容忍度

node.livenessProbePort

huawei-csi-node的存活性探针端口，用于健康检查。

是

9800

如果存在端口冲突可修改为其他未占用的端口

node.kubeletVolumeDevicesDirName

kubelet挂载块设备时的目录名称。

否

volumeDevices

当一个块设备被成功挂载之后，挂载路径的目录结构应该如下所示：

/var/lib/kubelet/plugins/kubernetes.io/csi/{kubeletVolumeDevicesDirName}/publish/{specName}/{podUID}

csiDriver.driverName

注册的驱动名称。

是

csi.huawei.com

• 直接使用默认值。
• 对于CCE Agile平台，需要修改该字段，例如：csi.oceanstor.com。

csiDriver.endpoint

通信端点。

是

/csi/csi.sock

直接使用默认值。

csiDriver.connectorThreads

最大并发扫盘/卸盘数。参数格式为整型，支持范围为1~10。

是

4

该值设置越大，同一时间单个节点中的针对多路径的扫盘、卸盘并发操作就越多。在使用DM-Multipath时，并发数过大可能会导致未知问题，影响整体时间。

csiDriver.volumeUseMultipath

是否使用多路径软件。参数格式为布尔值。

是

true

强烈建议开启多路径软件，以增强存储链路的冗余度和性能。

csiDriver.scsiMultipathType

存储协议为fc/iscsi时，使用的多路径软件。支持配置如下参数：

• DM-multipath
• HW-UltraPath
• HW-UltraPath-NVMe

当volumeUseMultipath为true时必填。

DM-multipath

建议使用DM-multipath取值。

csiDriver.nvmeMultipathType

存储协议为roce/fc-nvme时，使用的多路径软件。仅支持配置HW-UltraPath-NVMe。

当volumeUseMultipath为true时必填。

HW-UltraPath-NVMe

-

csiDriver.scanVolumeTimeout

在主机上使用DM-Multipath多路径时，等待多路径聚合的超时时间，支持范围为1~600，单位秒。

是

3

-

csiDriver.execCommandTimeout

在主机上执行命令的超时时间

是

30

CSI插件在挂载，扩容盘符等场景下，需要运行一些主机命令，例如使用mount命令挂载文件系统。该配置用于控制执行单条命令的超时时间。

csiDriver.allPathOnline

是否检查DM-Multipath软件聚合的路径数等于实际在线的路径数，支持配置如下参数：

• true：DM-Multipath软件聚合的路径数等于实际在线的路径数才满足盘符挂载条件。
• false：默认不检查DM-Multipath软件聚合的路径数量，只要聚合出虚拟盘符，即满足盘符挂载条件。

当csiDriver.scsiMultipathType为DM-multipath时必填。

false

-

csiDriver.backendUpdateInterval

后端能力的更新时间间隔，支持范围60~600，单位秒。

是

60

-

csiDriver.controllerLogging.module

controller日志记录类型。支持配置如下参数：

• file
• console

是

file

使用file选项时，日志将被保留在节点指定的目录下，当CSI所在的Pod被销毁时，日志仍然被保留。

使用console选项时，日志将被保留在CSI所在Pod的临时空间中，当CSI所在的Pod被销毁时，日志也随之被销毁。

csiDriver.controllerLogging.level

controller日志输出级别。支持配置如下参数：

• debug
• info
• warning
• error
• fatal

是

info

-

csiDriver.controllerLogging.fileDir

controller日志在file输出模式下的日志目录。

是

/var/log/huawei

请确保该目录下有足够的空间保留日志。空间大小建议不小于200 MB。

csiDriver.controllerLogging.fileSize

controller日志在file输出模式下单个日志文件大小。

是

20M

-

csiDriver.controllerLogging.maxBackups

controller日志在file输出模式下日志文件备份上限。

是

9

-

csiDriver.nodeLogging.module

node日志记录类型。支持配置如下参数：

• file
• console

是

file

使用file选项时，日志将被保留在节点指定的目录下，当CSI所在的Pod被销毁时，日志仍然被保留。

使用console选项时，日志将被保留在CSI所在Pod的临时空间中，当CSI所在的Pod被销毁时，日志也随之被销毁。

csiDriver.nodeLogging.level

node日志输出级别。支持配置如下参数：

• debug
• info
• warning
• error
• fatal

是

info

-

csiDriver.nodeLogging.fileDir

node日志在file输出模式下的日志目录。

是

/var/log/huawei

请确保该目录下有足够的空间保留日志。空间大小建议不小于200 MB。

csiDriver.nodeLogging.fileSize

node日志在file输出模式下单个日志文件大小。

是

20M

-

csiDriver.nodeLogging.maxBackups

node日志在file输出模式下日志文件备份上限。

是

9

-

kubernetes.namespace

华为CSI运行时所在Kubernetes命名空间，支持用户自定义。名称必须由小写字母、数字和“-”组成，例如：my-name、123-abc。

否

huawei-csi

-

kubeletConfigDir

kubelet工作目录。

是

/var/lib/kubelet

• 直接使用默认值。
• 对于Tanzu平台，需要修改该字段为/var/vcap/data/kubelet。
• 对于CCE Agile平台，需要修改该字段为/mnt/paas/kubernetes/kubelet。

sidecarImagePullPolicy

sidecar镜像的拉取策略。

是

IfNotPresent

-

huaweiImagePullPolicy

huawei-csi镜像的拉取策略。

是

IfNotPresent

-

CSIDriverObject.isCreate

是否创建CSIDriver对象

是

false

CSIDriver特性在Kubernetes v1.18成为GA版本，因此要求Kubernetes版本高于v1.18，当Kubernetes版本低于 v1.18时，请设置该参数为false。

CSIDriverObject.attachRequired

CSI插件是否跳过attach操作。支持配置如下参数：

• true：需要attach操作。
• false：跳过attach操作。

是

true

参数attachRequired在Kubernetes v1.18支持配置。

如果CSIDriverObject.isCreate为true并且attachRequired参数设置为false时，huawei-csi插件将不会部署csi-attacher这个sidecar。

• 使用NAS存储时支持配置为false。
• 使用SAN存储时，请配置为true。

CSIDriverObject.fsGroupPolicy

基础卷是否支持在装载之前更改卷的所有权和权限。支持配置如下参数：

• "ReadWriteOnceWithFSType"：仅当定义了fsType并且卷的accessModes包含ReadWriteOnce时，才支持卷所有权和权限更改。
• "File"：Kubernetes可以使用fsGroup更改卷的权限和所有权，以匹配Pod安全策略中用户请求的fsGroup，而不管fsGroup或accessModes如何。
• "None"：将在不进行修改的情况下装载卷。
• "null"：将不设置fsGroupPolicy参数

否

null

参数fsGroupPolicy在Kubernetes v1.20支持配置，并且当CSIDriverObject.isCreate为true时该参数生效。

该特性在Kubernetes v1.20中为Beta版本，在Kubernetes v1.23成为GA版本，因此要求Kubernetes版本高于v1.20。

leaderElection.leaseDuration

领导者持续时间。

否

8s

仅多controller场景生效。

leaderElection.renewDeadline

领导者重新选举时间。

否

6s

仅多controller场景生效。

leaderElection.retryPeriod

领导者选举重试时间。

否

2s

仅多controller场景生效。