容器集群中的组件定期迭代，推荐升级到最新版本以使用最新功能或规避风险，本文为您介绍 csi\-nas 组件升级的升级风险、升级步骤、升级完成后的验证方式等。 ## 已知问题 csi\-nas 组件更新记录参见：[csi-nas](https://www.volcengine.com/docs/6460/152593)，若您仍在使用当前组件的低版本，可能存在以下问题。 |**问题现象** |**问题原因** |**影响版本** |**修复版本** | |---|---|---|---| |通过弹性容器实例（VCI）方式部署组件时，动态卷子目录权限不为 777。 |通过 VCI 方式部署组件时，依然在节点上创建动态卷的子目录，由于节点默认 umask 为 0022，导致创建的目录权限为 0755。 |< v1.2.7|v1.2.7|\ | | | | | |目录不是挂载点，unmount 失败，Pod 处于 Terminating 状态。 |由于引用 Kubernetes 社区的 mount\-utils 库，若 umount 时不是挂载点，则返回错误信息，需要检查错误内容。 |* v1.2.3|v1.2.5 |\ | | |* v1.2.4| |\ | | || |\ | | | | | |挂载点不可用。|Force Umount 导致挂载相同远端 NAS 的其它本地挂载点不可用。 |< v1.2.3 |v1.2.3 |\ | | | | | |NFS Version 解析失败。 |无。 |< v1.0.3 |v1.0.3 | ## 升级风险组件升级过程或组件升级失败时，不会影响存量业务。组件升级过程中，将重建组件相关工作负载，会导致正在处理且未完成的操作受到影响，表现为资源状态无法就绪。组件升级成功后，未完成的操作会自动重试，等待资源状态就绪即可，无需人为干预。组件升级过程中可能受到影响的操作如下： * 创建存储卷声明（动态卷）：由于创建卷未成功导致存储卷声明未绑定。 * 删除存储卷声明（动态卷）：由于删除卷未成功，导致存储卷声明卡在 Terminating 状态。 * 创建工作负载：由于挂载卷未成功导致工作负载处于 ContainerCreating 状态。 * 删除工作负载：由于卸载卷未成功导致工作负载处于 Terminating 状态。 :::tip 若业务对存储卷声明的绑定时间和工作负载的启动成功率要求较高，需要进一步评估影响，建议在业务低峰期升级组件。 ::: ## 升级步骤前往目标集群的组件管理页面，单击待升级组件右上角` ... `中的 **升级**，一键升级到最新版本。更多详细说明参见：[升级组件](https://www.volcengine.com/docs/6460/159826)。 :::warning * 若升级失败，可根据报错提示修复故障后重新升级。 * 若升级过程遇到问题或期望升级到指定版本，可联系官方售前或 [提交工单](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000210) 获取技术支持。 ::: ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_4eca8c4f605e34d8b3e3cbcc73b9b3c9.png =988x) ## 结果验证 ### 方式一：通过控制台验证 1. 登录 [容器服务控制台](https://console.volcengine.com/vke)，在集群列表页面，单击目标集群名称，前往集群管理页面。 2. 前往 **无状态负载** 页面，检查 `kube-system `命名空间中的无状态负载 `csi-nas-controller` 是否处于就绪状态，若所有 Pod 均处于就绪状态，则代表升级成功。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1e09758e834fe2e2394f9666696eb2c4.png =988x) 3. 前往 **守护进程** 页面，检查 `kube-system` 命名空间中的守护进程` csi-nas-node `是否处于就绪状态，若所有 Pod 均处于就绪状态，则代表升级成功。 ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f9e8886da277256120fe07614de0507a.png =988x) ### 方式二：使用命令行验证 [通过 kubectl 连接目标集群](https://www.volcengine.com/docs/6460/100942)，依次执行以下命令，检查组件相关状态。 1. 执行以下命令，检查 `kube-system` 命名空间中的无状态负载 `csi-ebs-controller` 是否处于就绪状态，若所有 Pod 均处于 READY 状态，则代表升级成功。 ```Bash kubectl get deployment csi-nas-controller -nkube-system ``` ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_3c4d878875ce74148e603e1f6c766b5b.png =988x) 2. 执行以下命令，检查 `kube-system` 命名空间中的守护进程 `csi-ebs-node` 是否处于就绪状态，若所有 Pod 均处于 READY 状态，则代表升级成功。 ```Bash kubectl get daemonset csi-nas-node -nkube-system ``` ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_0c7385cbc6adfc028df478dcd161b8d1.png =988x) 3. 执行以下命令，检查 csi\-ebs 组件相关 Pod 是否正常运行，若所有 Pod 均处于 Running 状态，则代表正常运行。 ```Bash kubectl get pods -nkube-system | grep csi-nas ``` ![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f9bc35dd6bbea7894ec7035da14aea10.png =988x)