文档中心

容器服务

请输入

存储组件

csi-fsx

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

组件概述

csi-fsx 是容器服务提供的下一代高性能存储插件，主要用于将对象存储（TOS）、弹性文件存储（EFS）等多种后端存储统一挂载到集群的 Pod 中。该组件相比早期的其他存储组件，具备更优的读写性能、更强的故障自愈能力以及更完善的权限管理机制。

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

资源名称	资源类型	资源说明
csi-fsx-node	DaemonSet	存储卷挂载 Pod，运行在集群的每一个计算节点上，作为标准的 CSI 节点驱动接收并处理节点侧的实际挂载与卸载请求。
fsx-agent	Pod	FSX 客户端。当在集群中创建工作负载，并使用 FSX 挂载存储卷时，系统会同步创建该 Pod，用于挂载指定的存储卷。

说明

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

组件版本

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

组件配置

安装组件

登录容器服务控制台。

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

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

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

参数	描述
服务账号	展示 csi-fsx 组件的服务账号（Service Account）信息，不支持修改。
命名空间	展示 csi-fsx 组件服务账号所在的命名空间，默认为 kube-system，不支持修改。
鉴权方式	勾选服务账号的 IAM 角色（IRSA），启用 IRSA 鉴权，并选择正确的 IAM 角色。注意必须开启 IRSA OIDC，才可以启用 IRSA 鉴权。详情请参见集群中使用 IRSA 能力。 IAM 角色必须使用 OIDC 身份提供商类型，并需绑定本集群服务账号的信任关系。详情请参见使用 IRSA 实现存储挂载鉴权。鉴权方式配置完成后不支持修改，如果需要修改鉴权方式，请卸载并重装组件。

单击确定，完成配置。

客户端配置

说明

FSX 客户端（FSX Agent）是容器服务中负责处理节点与后端存储（如 TOS、EFS 等）鉴权、数据卷挂载和数据读写的代理组件。客户端配置允许您指定不同的客户端镜像版本、客户端资源和清理策略，并基于标签实现节点级灰度升级或异构节点专属定制。更多配置详情，请参见使用 FSXSet 实现客户端升级与差异化配置。

单击 csi-fsx 组件卡片右下角的... > 客户端配置。

在弹出的客户端配置页面中，单击创建客户端配置，配置自定义客户端。

配置项	说明
配置名	FSXSet 资源名称，该名称在集群中需保持唯一，不与其他 FSXSet 资源名称冲突。
客户端镜像	在下拉菜单中选择需要使用的 FSX 客户端镜像版本号。
清理策略	配置当节点上不再有业务 Pod 使用 FSX 存储卷时，系统是否自动回收（销毁）该节点上的 FSX 客户端 Pod 以节省资源。不清理：客户端 Pod 将持续运行，适用于存储访问频繁、希望避免客户端重建延迟的场景。清理：系统将自动销毁闲置的客户端 Pod，适用于资源敏感或存储访问不频繁的节点。
FSXSet 标签值	自定义节点标签值，仅匹配该标签值的节点，会执行该 FSX 客户端配置。说明标签键固定为fsx.csi.volcengine.com/group，此处只需配置标签值即可。如果节点未匹配上任意自定义标签值，则使用系统默认提供的 default 策略。
资源配置	根据节点的性能需求，配置 FSX 客户端容器的 CPU 和内存的请求值和上限值。
更多配置
节点缓存目录	用于存放 FSX 客户端读写远端存储时产生的临时数据，以加速重复读取并缓解网络 I/O 压力。默认为/tmp/fsx目录。

单击确定，完成配置。

升级组件

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

观测与告警

组件观测

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

开启组件观测后，您可以在控制台中查看组件预置观测看板。该看板主要展示 FSX 客户端和 csi-fsx 链路的运行状态，包括 FSX 客户端带宽、IOPS、时延、IO Error、控制器 Error、CPU 利用率、内存利用率、客户端数量、客户端版本，以及 fsx-service、fsx-agent 的请求频率、失败频率、处理延迟和生命周期管理指标等。支持设置查询的时间段，并指定刷新方式（手动刷新、自动刷新）。

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

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

配置告警

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

使用预置模板配置告警

使用自定义模板配置告警

自定义告警规则

预置告警模板由系统根据常见运维场景预置，适合首次建设告警体系或快速补充基础监控项，帮助您及时发现组件资源不足或运行异常。预置告警模板告警规则详情，请参见预置告警模板。