FSXSet 是用于管理 FSX 客户端的 Kubernetes 自定义资源，允许按节点分组管理 FSX 客户端的部署、版本和升级策略，适合需要进行差异化配置、按需创建和客户端升级的场景。本文介绍 FSXSet 资源的基本概念和配置说明。 ## 资源概述 FSXSet 是一个集群级别的 Kubernetes 自定义资源，用于集中管理 FSX 客户端的全生命周期（创建、删除、热升级等）。同时，您可以通过创建一个或多个 FSXSet 对象，控制不同节点上的 FSX 客户端配置，例如资源规格、镜像版本、升级方式等。满足以下场景需求： * **平滑的节点级灰度升级**：支持根据需求构建不同的 FSXSet 配置，并仅将其下发给几台指定的测试节点。验证稳定后，再将新版本推向全集群，实现真正意义上的可控、可灰度热升级。 * **异构节点专属定制**：支持为不同的节点池指定不同的 FSXSet 配置。例如，针对 AI 智算节点池，可以为其专属配置调高客户端的 CPU/内存配额；针对闲置节点，支持开启自动清理策略以回收资源。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_d64a6cddbc8f081ace1d0cf1fa583fe1.jpeg) ## 核心功能通过使用 FSXSet 实现 FSX 客户端的管理时，主要包括如下核心功能。 |核心功能 |说明 | |---|---| |节点分组与按需管理 |* 通过节点标签`fsx.csi.volcengine.com/group`将节点划分为不同的逻辑组，允许不同逻辑分组实现不同的 FSX 客户端配置。

* 支持不同的 FSX 客户端创建模式，包括：Immediate（节点归属后立即创建）、WaitForFirstConsumer（业务按需创建），允许根据实际需求灵活选择。

* 支持配置按需自动回收，释放节点资源，适合资源紧张的场景。支持客户端常驻，加速首次挂载。 | |差异化配置 |* 通过创建多个 FSXSet 资源对象，为不同节点组配置差异化的 Pod 规格（CPU/Memory/网络资源等），实现差异化配置。例如在集群中为不同规格节点指定不同的 FSX 客户端配置。

* 通过 `parameterTemplate` 灵活定义 FSX 客户端模板。 | |热升级 |* 支持滚动升级（RollingUpdate）和灰度升级（OnLabel）策略。

* 通过修改 FSXSet 镜像字段即可触发升级，控制器自动编排新旧 Pod 交接。

* 支持 `maxSurge`/`maxUnavailable`控制升级并发度。 | ## 配置说明当您在集群中安装 fsxset\-controller 组件时，系统会自动同步安装 FSXSet 自定义资源。详情请参见 [fsxset-controller](https://www.volcengine.com/docs/6460/2309812)。您可以通过以下方法，查看或配置对应的 FSXSet 资源。通过控制台配置 1. 登录 [容器服务控制台](https://console.volcengine.com/vke)。 2. 在左侧导航栏中，选择 **集群**，单击目标集群名称，进入集群管理页面。 3. 在左侧导航栏中，选择 **组件管理**，并选择 **存储** 页签。 4. 单击 csi\-fsx 组件卡片右下角的 **`...`** ** \> 客户端配置**。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_df7734bcdcb1625a78c215576320a591.png) 5. 在弹出的客户端配置页面中，查看系统中的 FSXSet 资源。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1cb95223028c48178d1567b7aac589ad.png) 6. 选择目标资源，单击 **操作** 栏中的 **更新**，即可查看或更新 FSXSet 资源。

说明

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

通过 kubectl 配置 1. [使用 kubectl 连接集群](https://www.volcengine.com/docs/6460/100942)。 2. 执行以下命令，查看集群中的 FSXSet 资源。 ```Bash kubectl get fsxset ``` 预期结果如下，展示了集群中当前存在的 FSXSet 资源。 ```Bash NAME GROUP DESIREDREVISION DESIRED CURRENT READY AVAILABLE UPDATED MATCHED AGE default default ed48241c49*** 47h doc-demo doc e12fd97867*** 2 2 2 2 2 2 146m ``` 3. 执行以下命令，查看指定的 FSXSet 资源详情。其中`${fsxset-name}`为 FSXSet 资源名称。 ```Bash kubectl get fsxset ${fsxset-name} -o yaml ``` 预期结果和具体的参数解释，如下文所示。查看或配置 FSXSet 资源时，配置代码示例如下： ```YAML apiVersion: csi.vke.volcengine.com/v1alpha1 kind: FSXSet metadata: name: doc-demo # FSXSet 资源名称 spec: groupName: doc # 逻辑分组名称，与节点标签 fsx.csi.volcengine.com/group 对应，系统通过该名称选择执行该 FSXSet 配置的节点，实现客户端差异化配置 isDefault: true # 是否为集群默认配置，取值：true（系统默认配置）、false（非系统默认配置） createMode: WaitForFirstConsumer # FSX 客户端创建模式，取值：Immediate（节点归属后立即创建 FSX 客户端）、WaitForFirstConsumer（节点上首次部署依赖的业务时，才会创建 FSX 客户端） scaleDownAfterNoDependency: true # 当前节点上没有业务依赖 FSX 时，是否自动回收 FSX 客户端 Pod，取值：true（自动回收）、false（不自动回收） scaleDownAfterIdleDuration: 3m # 开启 FSX 客户端 Pod 自动回收时，系统的空闲等待时间 upgradeStrategy: type: RollingUpdate # FSX 客户端升级策略，取值：RollingUpdate（滚动升级）、OnLabel（灰度升级） maxSurge: 1 # 滚动升级时允许超出期望值额外创建的 Pod 数，默认为 1 maxUnavailable: 1 # 滚动升级时允许同时不可用的最大节点数，即滚动升级并发度 template: parameterTemplate: # FSX 客户端配置模板 image: vke-cn-beijing.cr.volces.com/vke/fsx-agent:v0.12.3 # FSX 客户端的镜像地址和版本 resources: # FSX 客户端资源配置 requests: cpu: 100m memory: 128Mi limits: cpu: 2000m memory: 2Gi ``` 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。

注意

当该参数配置为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 资源中，当未配置该参数时，不会额外挂载该目录。 |