FAQ
Pod 创建失败,错误信息 "driver name csi.juicefs.com not found in the list of registered CSI drivers"
检查 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 实际的根目录路径。检查 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 驱动版本?
请参考「故障排查」文档了解详细步骤。