FSXSet 是用于管理 FSX 客户端的 Kubernetes 自定义资源，允许按节点分组管理 FSX 客户端的部署、版本和升级策略，适合需要进行差异化配置、按需创建和客户端升级的场景。本文介绍 FSXSet 资源的基本概念和配置说明。

资源概述

FSXSet 是一个集群级别的 Kubernetes 自定义资源，用于集中管理 FSX 客户端的全生命周期（创建、删除、热升级等）。同时，您可以通过创建一个或多个 FSXSet 对象，控制不同节点上的 FSX 客户端配置，例如资源规格、镜像版本、升级方式等。满足以下场景需求：

平滑的节点级灰度升级：支持根据需求构建不同的 FSXSet 配置，并仅将其下发给几台指定的测试节点。验证稳定后，再将新版本推向全集群，实现真正意义上的可控、可灰度热升级。

异构节点专属定制：支持为不同的节点池指定不同的 FSXSet 配置。例如，针对 AI 智算节点池，可以为其专属配置调高客户端的 CPU/内存配额；针对闲置节点，支持开启自动清理策略以回收资源。

核心功能

通过使用 FSXSet 实现 FSX 客户端的管理时，主要包括如下核心功能。

核心功能	说明	相关文档
节点分组与按需管理	通过节点标签fsx.csi.volcengine.com/group将节点划分为不同的逻辑组，允许不同逻辑分组实现不同的 FSX 客户端配置。支持不同的 FSX 客户端创建模式，包括：Immediate（节点归属后立即创建）、WaitForFirstConsumer（业务按需创建），允许根据实际需求灵活选择。支持配置按需自动回收，释放节点资源，适合资源紧张的场景。支持客户端常驻，加速首次挂载。	使用 FSXSet 实现客户端按需创建
差异化配置	通过创建多个 FSXSet 资源对象，为不同节点组配置差异化的 Pod 规格（CPU/Memory/网络资源等），实现差异化配置。例如在集群中为不同规格节点指定不同的 FSX 客户端配置。通过 parameterTemplate 灵活定义 FSX 客户端模板。	使用 FSXSet 实现客户端差异化配置
热升级	支持滚动升级（RollingUpdate）和灰度升级（OnLabel）策略。通过修改 FSXSet 镜像字段即可触发升级，控制器自动编排新旧 Pod 交接。支持 maxSurge/maxUnavailable控制升级并发度。	使用 FSXSet 实现客户端平滑升级

配置说明

当您在集群中安装 fsxset-controller 组件时，系统会自动同步安装 FSXSet 自定义资源。详情请参见 fsxset-controller。您可以通过以下方法，查看或配置对应的 FSXSet 资源。

通过控制台配置

通过 kubectl 配置

登录容器服务控制台。

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

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

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

在弹出的客户端配置页面中，查看系统中的 FSXSet 资源。

选择目标资源，单击操作栏中的更新，即可查看或更新 FSXSet 资源。

说明

如需配置更多功能，可以在工作负载 > 对象浏览器中，查看或修改 FSXSet 资源对应的 YAML 配置。

查看或配置 FSXSet 资源时，配置代码示例如下：

FSXSet 资源中的关键参数说明，如下表所示。

类型	参数	是否必填	说明
基础	metadata.name	是	FSXSet 资源名称，同一个集群下，该名称必须唯一。
		spec.groupName	否	逻辑分组名称，与节点标签fsx.csi.volcengine.com/group对应，系统通过该名称选择执行该 FSXSet 配置的节点，实现客户端差异化配置。该参数不允许配置为空字符串。如果未配置该参数，则使用系统中的 FSXSet 默认配置（名称为 default）。说明例如：当该参数配置为doc时，仅节点标签为fsx.csi.volcengine.com/group=doc的节点，会执行当前 FSXSet 配置。详情请参见使用 FSXSet 实现客户端差异化配置。
		spec.isDefault	否	是否为集群默认 FSXSet，用于接管未命中其他分组规则的节点。包括： true：集群默认 FSXSet。 false：（默认值）非集群默认 FSXSet。说明集群中最多只能有一个isDefault取值为true的资源对象。未配置该参数时，默认为false，即非系统默认 FSXSet。
管理策略	spec.createMode	否	FSX 客户端创建模式。包括： Immediate：节点成功归属到资源分组后，立即创建 FSX 客户端。 WaitForFirstConsumer：（默认值）节点上首次部署依赖的业务时，才会创建 FSX 客户端。注意当该参数配置为Immediate时，scaleDownAfterNoDependency 不支持配置为true。
		spec.scaleDownAfterNoDependency	否	当前节点上没有业务依赖 FSX 时，是否自动回收 FSX 客户端 Pod。包括： true：自动回收 FSX 客户端 Pod，适用于希望降低空闲资源占用的场景。 false：（默认值）不自动回收 FSX 客户端 Pod。该模式下 ECS 实例首次挂载时，速度更快。注意当该参数配置为true时，createMode不支持配置为Immediate。
		spec.scaleDownAfterIdleDuration	否	开启 FSX 客户端 Pod 自动回收时，系统的空闲等待时间。 Go duration 格式字符串形式，单位支持 s（秒）、m（分钟）、h（小时）。例如配置为5m时，表示 5 分钟。当未配置该参数时，默认值为 3m。
		spec.upgradeStrategy.type	否	FSX 客户端升级策略。包括： RollingUpdate：滚动升级。 OnLabel：灰度/轮转升级。注意 FSX 客户端的升级步骤和注意事项，请参见 FSX 客户端升级。在系统默认创建的 FSXSet 资源（名称为 default）中，该参数的默认值为OnLabel；在用户新创建的 FSXSet 资源中，该参数的默认配置为RollingUpdate。
		spec.upgradeStrategy.maxSurge	否	滚动升级时允许临时多创建的 Pod 数。仅spec.upgradeStrategy.type配置为RollingUpdate时，需要配置该参数。整数形式，默认值为 1。当配置为 0 时，系统不会先扩出新 Pod，而是先删除旧 Pod、再创建新 Pod，因此不额外占用资源，但单个节点在切换瞬间可能短暂中断。
		spec.upgradeStrategy.maxUnavailable	否	滚动升级时允许同时不可用的最大节点数，即滚动升级并发度。例如配置为 1 时，表示每次只升级一个节点。仅spec.upgradeStrategy.type配置为RollingUpdate时，需要配置该参数。当未配置该参数时，默认值为 1。
客户端配置	template.parameterTemplate.image	是	FSX 客户端的镜像地址和版本。注意在RollingUpdate模式下，修改镜像版本会直接触发 FSX 客户端升级。可以从组件配置控制台中，获取系统当前支持的镜像地址和版本。详情请参见 csi-fsx。
		template.parameterTemplate.resources	否	FSX 客户端 Pod 的资源配额。当未配置该参数时，则使用全局默认配置。
		template.parameterTemplate.hostWorkDirectory	否	FSX 客户端在宿主机上的工作目录，用于缓存和临时文件，并挂载到容器内/tmp/fsx。在系统默认创建的 FSXSet 资源（名称为 default）中，会继承 Controller 的 cacheDirectory 配置，默认通常为/tmp/fsx。在用户新创建的 FSXSet 资源中，当未配置该参数时，不会额外挂载该目录。

容器服务