Skip to main content

FAQ

Pod 创建失败，错误信息 "driver name csi.juicefs.com not found in the list of registered CSI drivers"

  1. 检查 kubelet 根目录

    在任意非 master 节点执行以下命令：

    ps -ef | grep kubelet | grep root-dir

    如果前面检查命令返回的结果不为空，则代表 kubelet 的根目录（--root-dir）不是默认值（/var/lib/kubelet），因此需要在 CSI Driver 的部署文件中更新 kubeletDir 路径并部署：

    # Kubernetes version >= v1.18
    curl -sSL https://raw.githubusercontent.com/juicedata/juicefs-csi-driver/master/deploy/k8s.yaml | sed 's@/var/lib/kubelet@{{KUBELET_DIR}}@g' | kubectl apply -f -

    # Kubernetes version < v1.18
    curl -sSL https://raw.githubusercontent.com/juicedata/juicefs-csi-driver/master/deploy/k8s_before_v1_18.yaml | sed 's@/var/lib/kubelet@{{KUBELET_DIR}}@g' | kubectl apply -f -
    注意

    请将上述命令中 {{KUBELET_DIR}} 替换成 kubelet 实际的根目录路径。

  2. 检查 pod 所在节点是否运行有 JuiceFS node service

    参考 issue #177，运行如下命令：

    kubectl -n kube-system get po -owide | grep juicefs
    kubectl get po -owide -A | grep <your_pod>

    如果您的 pod 所在节点上没有 JuiceFS CSI node，请检查该节点是否存在污点。您可以删除污点，或给 JuiceFS CSI driver DaemonSet 打上对应的容忍，并重新部署。

两个 pod 分别使用各自的 PVC，但只有一个能创建成功。

请检查每个 PVC 对应的 PV，每个 PV 的 volumeHandle 必须保证唯一。您可以通过以下命令检查 volumeHandle：

$ kubectl get pv -o yaml juicefs-pv
apiVersion: v1
kind: PersistentVolume
metadata:
  name: juicefs-pv
  ...
spec:
  ...
  csi:
    driver: csi.juicefs.com
    fsType: juicefs
    volumeHandle: juicefs-volume-abc
    ...

元数据引擎使用阿里云的 Redis 服务，CSI node pod 中报错信息 "format: ERR illegal address: xxxx"

请检查阿里云 Redis 服务的白名单中，是否添加 Kubernetes 集群的节点 IP。

CSI node pod 中报错信息 "format: NOAUTH Authentication requested."

当使用 Redis 作为元数据引擎时，元数据引擎 URL 中需要包含密码，具体格式请参考文档。

如何查看当前已安装的 JuiceFS CSI 驱动版本？

请参考「故障排查」文档了解详细步骤。