更新时间:2025-09-11 GMT+08:00
分享

节点挂载检查异常处理

检查项内容

本文档提供了对节点挂载检查异常处理的排障指导,帮助用户解决在CCE节点中可能遇到的节点存储配置问题。

解决方案

  • 检查子项1:挂载点冲突检查(checkMountPath)

    检查内容

    确保这些关键路径没有被意外挂载,CCE需要使用这些路径的子目录,如果路径本身已被挂载,节点重启或节点组件升级重启时可能因路径无法访问而导致异常:

    当存在vgpaas-share卷组时(共享磁盘):只检查/mnt路径

    当不存在vgpaas-share卷组时(非共享磁盘):检查/mnt、/mnt/paas、/mnt/paas/kubernetes、/var、/var/lib路径

    解决方案

    收到 "the file path xxx is mounted, but the subpath is used by the CCE" 错误,提示某路径已被挂载但子路径被CCE使用。建议检查节点安装前执行脚是否存在相关挂载命令,去除或选择其他目录挂载,完成后排空节点Pod并重置节点。

  • 检查子项2:符号链接/挂载绑定检查 (checkLinkPath)

    检查内容

    验证以下关键目录是否正确配置:

    1. 基础检查:/var/lib/kubelet是否链接到/mnt/paas/kubernetes/kubelet
    2. 条件检查,当存在vgpaas-share卷组时(共享磁盘):
      • 如果使用Docker:/var/lib/docker是否链接到/mnt/paas/runtime
      • 如果使用Containerd:/var/lib/containerd是否链接到/mnt/paas/runtime

    解决方案

    收到 "the target path of the path link xxx" 错误,提示路径链接不存在或目标不符合预期。如果错误符号链接下已经存储数据(ls命令返回不为空),建议排空节点Pod重置节点。下列方案仅在错误符号链接或挂载点下无数据时实施。以/var/lib/kubelet为例:

    • 情况一:需要创建符号链接

      创建符号链接命令如下:

      sudo ln -sf /mnt/paas/kubernetes/kubelet /var/lib/kubelet
    • 情况二:符号链接目标不正确
      1. 移除错误符号链接。
        sudo rm /var/lib/kubelet
      2. 创建正确符号链接。
        sudo ln -sf /mnt/paas/kubernetes/kubelet /var/lib/kubelet

常见问题

问题一:如何确认是否存在vgpaas-share卷组(共享磁盘)

  1. 根据检查信息,登录相应节点。
  2. 执行lsblk命令,查看/mnt/paas挂载了vgpaas-share分区,若存在则是共享磁盘场景,若不存在,则是非共享磁盘场景。

    图1 查询是否为共享磁盘

相关文档