组件介绍
注意事项
如果同时安装 COS-CSI v1.0.5 及以上版本和 CFS-CSI v1.1.6 及以下版本，由于两个组件中的 DaemonSet 同时开启了 hostNetwork，且 metrics 服务默认端口均为 9097，会导致端口冲突，其中一个 DaemonSet 的 Pod 会绑定失败，日志中会包含如下错误信息：
Failed to listen on :9097: listen tcp :9097: bind: address already in use。该问题会导致组件无法提供 metrics 服务，但不影响组件的主要功能。
修复该问题，可以修改 CFS-CSI 组件
daemonset -n kube-system csi-nodeplugin-cfsplugin，给cfs容器增加参数--metric_port=9096，显式指定 metrics 服务端口为9096（9096也是 CFS-CSI v1.1.7+ 版本的默认端口），避免跟 COS-CSI 端口冲突。变更记录
发布时间 | 版本号 | 变更内容 | 限制和影响 |
2025-06-26 | v1.0.11 | cosfs 工具更新到1.0.23版本，cos PV 挂载选项包含 -oenable_clientinfo 时，删除 cos 文件会记录发起删除请求的 pod 及容器 id 信息，方便追溯。 | 集群版本 > 1.18。 cosfs 托管方式为 Pod 时，升级会影响挂载方式为 cosfs 的已有业务，需修改 daemonset csi-coslauncher 及 csi-cosplugin 的更新策略为 OnDelete 后再升级组件，逐个节点迁移 cosfs 业务后进行升级。 托管方式为 CVM 或者使用 goosefs-lite 挂载方式时，升级不会对已有业务造成影响。升级过程中存在组件不可用情况，建议业务低峰期升级。 |
2025-01-08 | v1.0.8 | 升级时，保留手动设置的 daemonset csi-coslauncher 及 csi-cosplugin 的 OnDelete 更新策略，避免滚动更新影响 Pod 托管方式的存量 cosfs 业务。 | 集群版本 > 1.18。 cosfs 托管方式为 Pod 时，升级会影响挂载方式为 cosfs 的已有业务，需修改 daemonset csi-coslauncher 及 csi-cosplugin 的更新策略为 OnDelete 后再升级组件，逐个节点迁移 cosfs 业务后进行升级。 托管方式为 CVM 或者使用 goosefs-lite 挂载方式时，升级不会对已有业务造成影响。升级过程中存在组件不可用情况，建议业务低峰期升级。 |
2024-12-17 | v1.0.7 | 修复1.0.5引入的 cosfs 托管方式为 Pod 时，业务 Pod 退出会产生僵尸进程的问题。 | 集群版本 >1.18。 cosfs 托管方式为 Pod 时，升级会影响挂载方式为 cosfs 的已有业务，需修改 daemonset csi-coslauncher 及 csi-cosplugin 的更新策略为 OnDelete 后再升级组件，逐个节点迁移 cosfs 业务后进行升级。 托管方式为 CVM 或者使用 goosefs-lite 挂载方式时，升级不会对已有业务造成影响。升级过程中存在组件不可用情况，建议业务低峰期升级。 |
2024-09-26 | v1.0.6 | 默认关闭 cos launcher 的 coredump 设置，可以通过设置 env ENABLE_COREDUMP=true 来开启。 | 集群版本 >1.18。 cosfs 托管方式为 Pod 时，升级会影响挂载方式为 cosfs 的已有业务，需修改 daemonset csi-coslauncher 及 csi-cosplugin 的更新策略为 OnDelete 后再升级组件，逐个节点迁移 cosfs 业务后进行升级。 托管方式为 CVM 或者使用 goosefs-lite 挂载方式时，升级不会对已有业务造成影响。升级过程中存在组件不可用情况，建议业务低峰期升级。 |
2024-05-14 | v1.0.5 | cos-csi 增加挂载 target 健康状态指标。 cosfs 挂载操作支持托管到 cvm。 | 集群版本 >1.18。 cosfs 托管方式为 Pod 时，升级会影响挂载方式为 cosfs 的已有业务，需修改 DaemonSet csi-coslauncher 及 csi-cosplugin 的更新策略为 OnDelete 后再升级组件，逐个节点迁移 cosfs 业务后进行升级。 托管方式为 CVM 时或者使用 goosefs-lite 挂载方式，升级不会对已有业务造成影响。升级过程中存在组件不可用情况，建议业务低峰期升级。 |
2023-11-30 | v1.0.4 | cos-csi 插件收敛部分权限，提高组件安全性。 | cosfs 托管方式为 Pod 时，升级会影响挂载方式为 cosfs 的已有业务，需修改 Daemonset csi-coslauncher 及 csi-cosplugin 的更新策略为 OnDelete 后再升级组件，逐个节点迁移 cosfs 业务后进行升级。 托管方式为 CVM 或者使用 goosefs-lite 挂载方式时，升级不会对已有业务造成影响。升级过程中存在组件不可用情况，建议业务低峰期升级。 |
2023-09-21 | v1.0.3 | 优化: cosfs 挂载的时候 odbglevel 和 opasswd_file 参数以用户的配置为准。 umount 支持重入，防止挂载目录被删除后，pod一直 terminating。 升级 cosfs 版本，提高稳定性。 cosfs 配置 core dump，防止 cosfs 进程挂掉后无法追溯。 新增 feature: 新增 cos 使用 goose-lite 方式热挂载。 cos 组件开启全容忍。 | cosfs托管方式为 Pod 时，升级会影响挂载方式为 cosfs 的已有业务，需修改 daemonset csi-coslauncher 及 csi-cosplugin 的更新策略为 OnDelete 后再升级组件，逐个节点迁移 cosfs 业务后进行升级。 托管方式为 CVM 或者使用 goosefs-lite 挂载方式时，升级不会对已有业务造成影响。升级过程中存在组件不可用情况，建议业务低峰期升级。 |
2022-05-06 | v1.0.1 | 插件支持配置污点容忍。 | 此次升级不会对已有业务造成影响，升级过程中存在组件不可用情况，建议业务低峰期升级。 |
