- 文档首页
容器服务
容器服务 VKE
用户指南
存储
FSX 客户端
FSX 鉴权方式
FSX 鉴权方式
FSX 是用于挂载云端存储的客户端,通过该客户端,您可以把 TOS、NAS 等云端存储挂载到容器中,使得云端存储可以作为容器的本地文件系统,实现数据的存储和管理。本文介绍 FSX 在容器服务集群中使用时,支持的鉴权方式。
在容器服务中使用 FSX 挂载存储时,支持如下两种鉴权方式:
IRSA 鉴权为组件级别配置,当在 csi-fsx 组件中开启 IRSA 鉴权后,即可使用密钥鉴权或 IRSA 鉴权进行存储挂载。鉴权生效的逻辑如下:
- 当在组件中开启了 IRSA 鉴权,但未配置 PV 级别的密钥时,使用 IRSA 进行鉴权。
- 当在组件中开启了 IRSA 鉴权,同时配置 PV 级别的密钥时,优先使用密钥进行鉴权。
- 如都未配置,则鉴权失败。无法使用 FSX 访问存储卷。
说明
集群中存量 PV 不支持调整鉴权方式。因此,当您修改 csi-fsx 组件 IRSA 鉴权中的 IAM 角色后,对于存量 PV 不会生效。
当您使用密钥鉴权并更新 Secret 时,新的 Access Key ID 和 Secret Access Key 生效,需满足以下条件之一:
- 轮询刷新触发:系统对已登记的 Secret 周期性刷新,默认周期为 1 分钟。更新后的生效延迟通常 不超过 1 个刷新周期。
- 挂载请求触发:当您下一次发起使用该 Secret 的挂载请求时,会在请求内立即刷新。如果刷新成功,则在该次请求中就会使用到更新后的凭据。
说明
系统暂时不提供基于 watch/informer 的“秒级实时”生效机制。
问题 1:更新了 Secret,为什么没有立刻生效?
系统暂不支持基于 watch/informer 订阅的 Secret 变更。更新后的生效仅依赖 2 种触发方式。如上文 密钥更新逻辑 所述。 - 定时轮询刷新失败:系统会记录错误并保留上一次成功写入的凭据文件,在后续轮询周期继续尝试刷新。
- 挂载请求内强制刷新失败:该次挂载请求会直接失败,并返回挂载失败错误于 Pod Event 中。
如果 Access Key ID 或 Secret Access Key 缺失,系统会把空字符串写入凭据文件,但不会在读取阶段显式报错;是否最终可用取决于后续挂载组件对空凭据的处理。
最近更新时间:2026.04.07 11:33:22