在Kubernetes部署JupyterHub时，如何解决PVC 'hub-db-dir'权限禁止错误？

问题原因 #

你遇到的错误persistentvolumeclaims "hub-db-dir" is forbidden: Internal error occurred: 8 default StorageClasses were found，核心原因是你的Kubernetes集群里存在8个被标记为默认（default）的StorageClass。当JupyterHub的Helm Chart尝试创建hub-db-dir这个PVC时，由于没有指定具体的StorageClass，Kubernetes没办法从多个默认选项里自动选择，直接导致PVC创建失败。

解决方案 #

你可以通过以下两种方式解决这个问题：

方案1：清理集群中的多余默认StorageClass（推荐）

Kubernetes只允许存在一个默认StorageClass，所以我们需要移除其他StorageClass的默认标记：

1. 先确认当前所有StorageClass的状态：

   kubectl get storageclass
   

2. 选一个你想保留为默认的StorageClass（比如gp2），然后把其他7个的默认标记移除。以aviral-worker-volume为例：

   kubectl patch storageclass aviral-worker-volume -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"false"}}}'
   

   对剩下的6个非目标StorageClass重复执行上述命令。
3. 再次验证结果，确保只有一个StorageClass带有(default)标记：

   kubectl get storageclass
   

4. 重新运行JupyterHub的Helm部署命令：

   RELEASE=jhub
   NAMESPACE=jhub
   helm upgrade --install $RELEASE jupyterhub/jupyterhub \
     --namespace $NAMESPACE \
     --version=0.8.2 \
     --values jupyter-hub-config.yaml
   

方案2：在JupyterHub配置中指定StorageClass

如果你不想修改集群的StorageClass设置，可以直接在jupyter-hub-config.yaml里明确指定要使用的StorageClass，让Helm Chart创建PVC时跳过默认选择逻辑：

1. 编辑你的配置文件，添加以下内容（替换为你想使用的StorageClass名称，比如gp2）：

   # 为hub的数据库PVC指定StorageClass
   hub:
     db:
       pvc:
         storageClassName: gp2
   
   # （可选）为单用户Notebook的存储PVC指定StorageClass
   singleuser:
     storage:
       dynamic:
         storageClassName: gp2
   

2. 保存配置后，重新运行Helm部署命令即可。

补充说明 #

Kubernetes的PVC创建逻辑是：当PVC未指定storageClassName时，会自动用集群的默认StorageClass生成对应的PV。但如果存在多个默认StorageClass，控制器会因为无法决策而抛出错误，这就是你遇到问题的本质。通过上述两种方法，要么让集群回到单一默认StorageClass的合规状态，要么直接指定目标StorageClass，都能解决这个问题。

内容的提问来源于stack exchange，提问作者Aviral Srivastava