文档中心

容器服务

请输入

存储组件

csi-nas

csi-nas 组件为基于标准 CSI 接口规范实现的文件存储（NAS）驱动组件。本文介绍如何安装、升级 csi-nas 组件及相关的注意事项。

组件概述

csi-nas 是容器服务提供的存储插件，主要用于将文件存储（NAS）挂载到集群的 Pod 中。通过该组件，您的多个 Pod 可以同时读写同一个共享文件系统。

该组件为非托管组件，需要在您的业务集群节点上运行，会占用少量的节点计算资源。组件安装后，会在 kube-system 命名空间中自动拉起以下 Kubernetes 资源。

资源名称	资源类型	资源说明
csi-nas-controller	Deployment	文件存储管理 Pod，负责监听集群内的存储需求（PVC/PV），并与 NAS/EFS 服务交互。
csi-nas-node	DaemonSet	文件存储挂载 Pod，运行在集群的每一个计算节点上，负责将 NAS/EFS 实际挂载到节点目录中。

说明

上表中仅罗列出了该组件的主要资源，以及配置组件或对应功能时可能使用到的资源，方便您了解该组件的主要组成。其他的组件相关资源（例如 ConfigMap、Secret 等）不多做介绍，请以集群中的实际为准。

组件版本

关于组件的历史发布记录、各版本新增特性及优化说明等信息，详情请参见组件发布记录。

安装组件

登录容器服务控制台。

在左侧导航栏中，选择集群，单击目标集群名称，进入集群管理页面。

在左侧导航栏中，选择组件管理，并选择存储页签。

将鼠标移动到组件卡片上，单击部署，配置组件相关参数。

参数	描述
部署方式	仅已安装了 vci-virtual-kubelet 组件的集群显示该参数。组件的部署方式。当前该参数已固定，不可配置。
部署形态	仅已安装了 vci-virtual-kubelet 组件的集群显示该参数。部署组件的节点类型，包括：云服务器部署：表示在集群中的云服务器节点（Node）上部署该组件。弹性容器部署：部署于弹性容器 VCI 实例上，将使用 1 个 2 vCPU、4 GiB 规格的 VCI 实例，且会产生额外的费用。详细的费用说明，请参见弹性容器实例产品计费。
节点健康检查端口	节点健康检查端口，默认为 9908。推荐配置为 12000 以内的端口。
节点标签选择	仅部署形态选择云服务器部署时，可配置该参数。开启后，可设置节点标签，组件的核心工作负载会被调度到带有该指定标签的节点上。
节点污点调度	仅部署形态选择云服务器部署时，可配置该参数。开启后，可设置污点容忍值，组件的核心工作负载允许被调度到带有指定污点的节点。
控制器资源配置	自定义组件内各控制器资源的 CPU 请求和上限、内存请求和上限。
节点资源配置	自定义组件内各节点资源的 CPU 请求和上限、内存请求和上限。

单击确认，完成配置。

升级组件

已知问题

csi-nas 组件更新记录参见：csi-nas，若您仍在使用当前组件的低版本，可能存在以下问题。

问题现象	问题原因	影响版本	修复版本
通过弹性容器实例（VCI）方式部署组件时，动态卷子目录权限不为 777。	通过 VCI 方式部署组件时，依然在节点上创建动态卷的子目录，由于节点默认 umask 为 0022，导致创建的目录权限为 0755。	< v1.2.7	v1.2.7
目录不是挂载点，unmount 失败，Pod 处于 Terminating 状态。	由于引用 Kubernetes 社区的 mount-utils 库，若 umount 时不是挂载点，则返回错误信息，需要检查错误内容。	v1.2.3 v1.2.4	v1.2.5
挂载点不可用。	Force Umount 导致挂载相同远端 NAS 的其它本地挂载点不可用。	< v1.2.3	v1.2.3
NFS Version 解析失败。	无。	< v1.0.3	v1.0.3

升级风险

组件升级过程或组件升级失败时，不会影响存量业务。组件升级过程中，将重建组件相关工作负载，会导致正在处理且未完成的操作受到影响，表现为资源状态无法就绪。组件升级成功后，未完成的操作会自动重试，等待资源状态就绪即可，无需人为干预。

组件升级过程中可能受到影响的操作如下：

创建存储卷声明（动态卷）：由于创建卷未成功导致存储卷声明未绑定。

删除存储卷声明（动态卷）：由于删除卷未成功，导致存储卷声明卡在Terminating状态。

创建工作负载：由于挂载卷未成功导致工作负载处于ContainerCreating状态。

删除工作负载：由于卸载卷未成功导致工作负载处于Terminating状态。

说明

若业务对存储卷声明的绑定时间和工作负载的启动成功率要求较高，需要进一步评估影响，建议在业务低峰期升级组件。

升级步骤

前往目标集群的组件管理页面，将鼠标移动到组件卡片上，单击 ... 中的升级，一键升级到最新版本。更多详细说明参见：升级组件。

注意

若升级失败，可根据报错提示修复故障后重新升级。

若升级过程遇到问题或期望升级到指定版本，可联系官方售前或提交工单获取技术支持。

检查组件状态

组件安装/升级完成后，您可以通过控制台或 kubectl 命令行，确认组件工作是否正常。

通过控制台验证

通过 kubectl 命令行验证

登录容器服务控制台。

在左侧导航栏中，选择集群。单击目标集群名称，进入集群管理页面。

在左侧导航栏中，选择工作负载 > 无状态负载，检查kube-system命名空间中的无状态负载csi-nas-controller是否处于就绪状态，若所有 Pod 均处于就绪状态，则代表升级成功。

在左侧导航栏中，选择工作负载 > 守护进程。检查kube-system命名空间中的守护进程csi-nas-node是否处于就绪状态，若所有 Pod 均处于就绪状态，则代表升级成功。

观测与告警

组件观测

csi-nas 组件稳定性和性能直接影响组件功能正常使用和效果，建议您在集群中开启组件观测，帮助您实时掌握组件的健康度。详情请参见 CSI 存储观测。

开启组件观测后，您可以在控制台中查看组件预置观测看板。该看板主要展示 csi-nas 组件运行状态和 NAS 卷操作链路，包括 Controller Pod 可用状态、Node Pod 可用状态、控制面操作积压、控制面 RPC 调用失败、节点 RPC 调用失败、节点 RPC 延迟和 NAS 操作状态等。支持设置查询的时间段，并指定刷新方式（手动刷新、自动刷新）。

在集群管理页面的左侧导航栏中，选择监控中心 > 监控看板。

在左侧看板列表中选择存储服务监控 > NAS 监控，即可查看监控看板。

配置告警

容器服务基于托管 Prometheus（VMP）提供完善的集群监控告警能力，您可以直接使用系统预置模板快速创建告警规则组，也可以基于业务实际需求自定义基于 PromQL 语句的告警规则，或在导出预置模板 YAML 后调整规则并沉淀为自定义告警模板，统一复用于多个集群。详情请参见：

使用预置模板配置告警

使用自定义模板配置告警

自定义告警规则