Helm部署PostgreSQL无法绑定PVC问题求助

问题背景 #

通过以下步骤部署Bitnami PostgreSQL时，出现PVC无法绑定到PV的问题：

1. 创建PV：

apiVersion: v1
kind: PersistentVolume
metadata:
  namespace: admin-4
  name: postgresql-pv-admin-4
  labels:
    type: local
spec:
  storageClassName: manual
  capacity:
    storage: 10Gi
  accessModes:
    - ReadWriteOnce
  hostPath:
    path: "/mnt/data"

2. 创建PVC：

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  namespace: admin-4
  name: postgresql-pvc-admin-4
spec:
  storageClassName: manual
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi

3. Helm安装命令：

helm install postgres bitnami/postgresql --set persistence.enabled=true --set persistence.existingClaim=postgresql-pvc-admin-4 --set volumePermissions.enabled=true -n admin-4

当前资源状态截图：

排查与解决步骤 #

1. 先获取绑定失败的具体原因 #

执行以下命令查看PVC和PV的事件日志，定位核心问题：

kubectl describe pvc postgresql-pvc-admin-4 -n admin-4
kubectl describe pv postgresql-pv-admin-4

2. 修复PV的命名空间配置错误 #

PersistentVolume是集群级资源，不需要指定namespace，你当前的PV配置中添加了namespace: admin-4，这会导致PV无法被正确识别。

修改PV配置，移除metadata.namespace字段：

apiVersion: v1
kind: PersistentVolume
metadata:
  name: postgresql-pv-admin-4
  labels:
    type: local
spec:
  storageClassName: manual
  capacity:
    storage: 10Gi
  accessModes:
    - ReadWriteOnce
  hostPath:
    path: "/mnt/data"

然后重新创建PV：

kubectl delete pv postgresql-pv-admin-4
kubectl apply -f pv.yaml

3. 验证存储类匹配性 #

确认manual存储类存在，且PV与PVC的storageClassName完全一致：

kubectl get storageclass

如果manual存储类不存在，先创建它：

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: manual
provisioner: kubernetes.io/no-provisioner
volumeBindingMode: WaitForFirstConsumer

应用存储类：

kubectl apply -f storageclass.yaml

4. 检查hostPath目录权限与节点亲和性 #

• 目录权限修复：在目标节点上确保/mnt/data目录存在，且权限符合Bitnami PostgreSQL的运行要求：

# 在对应K8s节点上执行
mkdir -p /mnt/data
chown 1001:1001 /mnt/data
chmod 755 /mnt/data

• 节点亲和性配置：如果集群有多个节点，hostPath PV仅能被创建它的节点访问，需给PV添加节点亲和性规则，确保Pod调度到对应节点：
  修改PV的spec部分添加：

nodeAffinity:
  required:
    nodeSelectorTerms:
    - matchExpressions:
      - key: kubernetes.io/hostname
        operator: In
        values:
        - <你的节点名称>

替换<你的节点名称>为实际节点名，可通过kubectl get nodes获取。

5. 重新触发绑定流程 #

删除现有PVC和Pod，重新创建以触发绑定：

kubectl delete pvc postgresql-pvc-admin-4 -n admin-4
kubectl delete pod -l app.kubernetes.io/name=postgresql -n admin-4
kubectl apply -f pvc.yaml

等待Pod重建后，检查绑定状态：

kubectl get pv,pvc -n admin-4

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