Gitlab Helm Chart配置Postgres自定义StorageClass后PVC未生效

1. 修正StorageClass的命名空间错误 #

StorageClass是集群级资源，不属于任何命名空间，你的配置里添加了namespace: gitlab会导致异常。修改StorageClass配置后重新应用：

apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: ebs-sc
# 移除下面这行无效配置
# namespace: gitlab
provisioner: kubernetes.io/aws-ebs
parameters:
  type: gp3
  iopsPerGB: "10"
  fsType: ext4
reclaimPolicy: Delete

执行更新命令：

kubectl apply -f storageclass.yml

2. 确认Helm Values参数是否生效 #

用helm template渲染模板，检查生成的Postgres PVC配置里的storageClassName是否正确：

helm template --namespace gitlab -f values.yml gitlab gitlab/gitlab | grep -A 10 "postgres.*persistentvolumeclaim"

如果输出中未显示storageClassName: ebs-sc，检查你的values.yml是否存在层级错误，或是有全局存储配置覆盖了Postgres的单独设置。

3. 清理已存在的旧PVC（若之前部署过） #

Helm不会自动替换已创建的PVC，如果之前的Postgres PVC使用了默认StorageClass，需要先删除再重新部署：

# 删除旧的Postgres PVC
kubectl delete pvc -n gitlab data-gitlab-postgresql-0
# 重新部署GitLab
helm upgrade --install --namespace gitlab -f values.yml gitlab gitlab/gitlab

4. 验证StorageClass状态 #

确认自定义StorageClass处于可用状态：

kubectl get storageclasses

确保ebs-sc的PROVISIONER为kubernetes.io/aws-ebs，STATUS显示Available。

5. 检查PVC绑定结果 #

部署完成后查看PVC的存储类配置：

kubectl get pvc -n gitlab

若data-gitlab-postgresql-0的STORAGECLASS列显示ebs-sc，说明配置已生效。

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