文档中心

容器服务

请输入

存储组件

csi-vepfs

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

组件概述

csi-vepfs 是容器服务提供的存储插件，主要用于将 vePFS 文件存储挂载到集群的 Pod 中。该组件能为高性能计算、AI 大模型训练等场景提供超高吞吐、超低延迟的共享文件系统访问能力。

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

资源名称	资源类型	资源说明
csi-vepfs-controller	Deployment	vePFS 文件存储管理 Pod，负责监听集群内的存储需求（PVC/PV），并负责与 vePFS 文件存储交互，维护挂载集群的节点一致性。
csi-vepfs-node	DaemonSet	vePFS 文件存储挂载 Pod，运行在集群的每一个计算节点上，负责在节点侧执行具体的挂载操作，将文件存储实际挂载为容器可用的文件系统。

说明

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

组件版本

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

安装组件

登录容器服务控制台。

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

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

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

参数	描述
节点标签选择	仅部署形态选择云服务器部署时，可配置该参数。开启后，可设置节点标签，组件的核心工作负载会被调度到带有该指定标签的节点上。
节点污点调度	仅部署形态选择云服务器部署时，可配置该参数。开启后，可设置污点容忍值，组件的核心工作负载允许被调度到带有指定污点的节点。
节点资源配置	自定义组件内各资源的 CPU 请求和上限、内存请求和上限。

单击确认，完成配置。

升级组件

组件会不定期发布新版本以提供新特性或修复已知问题。当组件卡片提示有可用更新时，建议您及时进行升级。为确保业务平稳过渡，升级前请尽量安排在业务低峰期执行操作。关于升级的操作步骤和注意事项，请参见升级组件。

观测与告警

组件观测

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

开启组件观测后，您可以在控制台中查看组件预置观测看板。该看板主要展示 vePFS CSI 组件、vePFS client 和文件系统集群的运行状态，包括成员节点数、client pod 数、异常节点数、client pod 部署 P99 时延、OpenAPI 请求 QPS、OpenAPI 错误率和时延等。支持设置查询的时间段，并指定刷新方式（手动刷新、自动刷新）。

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

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

配置告警

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

使用预置模板配置告警

使用自定义模板配置告警

自定义告警规则