无法将Azure存储卷挂载至Kubernetes部署，请求排查问题

你遇到的核心问题是PersistentVolumeClaim（PVC）未绑定到PersistentVolume（PV），导致Pod无法调度。根源在于你混淆了Azure Blob存储与Azure File存储的Kubernetes驱动配置，以下是具体排查和修正步骤：

1. 核心错误点 #

• 你使用了kubernetes.io/azure-file存储驱动，这是针对Azure File文件共享的驱动，而非Azure Blob存储。Blob存储需要使用Azure官方提供的blob.csi.azure.com CSI驱动。
• PV配置中使用azureFile字段，完全不符合Blob存储的配置规范，集群无法识别并绑定PVC。
• StorageClass参数中的containerName是Blob存储的概念，但azure-file驱动不识别该参数，导致存储资源无法正确关联。

2. 修正步骤 #

第一步：清理错误资源 #

先删除现有配置，避免冲突：

kubectl delete deployment nginx-deployment
kubectl delete pvc current-pvc
kubectl delete pv persistent-volume
kubectl delete storageclass azure-blob

第二步：安装Azure Blob CSI驱动 #

本地K8s集群（如minikube、k3s）默认没有内置Blob存储驱动，需要手动安装：

# 添加helm仓库
helm repo add azure https://kubernetes-sigs.github.io/azurefile-csi-driver/
# 安装Blob CSI驱动
helm install blob-csi-driver azure/blob-csi-driver --namespace kube-system

第三步：验证Secret正确性 #

确保你创建的azure-secret包含正确的存储账户名和密钥，格式如下：

apiVersion: v1
kind: Secret
metadata:
  name: azure-secret
type: Opaque
data:
  azurestorageaccountname: <base64编码的存储账户名>
  azurestorageaccountkey: <base64编码的存储账户密钥>

也可以用命令快速创建：

kubectl create secret generic azure-secret --from-literal=azurestorageaccountname=gravitasexpstorageclass --from-literal=azurestorageaccountkey=<你的存储账户密钥>

第四步：创建正确的StorageClass #

使用Blob CSI驱动的StorageClass配置：

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: azure-blob
provisioner: blob.csi.azure.com
parameters:
  storageAccount: gravitasexpstorageclass
  containerName: new-storage
  skuName: Standard_LRS
  resourceGroup: <你的存储账户所在资源组名称> # 必填，需替换为实际值
reclaimPolicy: Retain
volumeBindingMode: Immediate

第五步：创建Blob存储对应的PV #

apiVersion: v1
kind: PersistentVolume
metadata:
  name: persistent-volume
spec:
  capacity:
    storage: 2Gi
  accessModes:
    - ReadWriteMany # Blob存储支持多节点读写，也可根据需求改为ReadOnlyMany
  persistentVolumeReclaimPolicy: Retain
  csi:
    driver: blob.csi.azure.com
    volumeHandle: gravitasexpstorageclass-new-storage # 格式：存储账户名-容器名
    volumeAttributes:
      storageAccount: gravitasexpstorageclass
      containerName: new-storage
    nodeStageSecretRef:
      name: azure-secret
      namespace: default
  storageClassName: azure-blob

第六步：创建PVC #

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: current-pvc
spec:
  accessModes:
    - ReadWriteMany # 需与PV的accessModes一致
  storageClassName: azure-blob
  volumeName: persistent-volume
  resources:
    requests:
      storage: 2Gi

第七步：重新部署Deployment #

你的Deployment配置无需修改，直接重新创建即可：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx
        ports:
        - containerPort: 80
        volumeMounts:
        - name: azure-storage
          mountPath: /usr/share/nginx/html
      volumes:
      - name: azure-storage
        persistentVolumeClaim:
          claimName: current-pvc 

3. 验证操作 #

执行以下命令确认资源状态：

• 查看PVC绑定状态：kubectl get pvc current-pvc，状态应为Bound
• 查看Pod运行状态：kubectl get pods，状态应为Running
• 验证挂载：kubectl exec -it <pod-name> -- ls /usr/share/nginx/html，应能看到Blob容器内的文件

4. 额外排查点 #

• 确保本地K8s集群节点能正常访问Azure存储账户，无防火墙/网络策略限制
• 存储账户的资源组名称必须与StorageClass中配置一致
• 存储账户密钥未过期，且拥有Blob容器的读写权限

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