Kubernetes部署PostgreSQL时挂载Persistent Volume出现postgresql.conf不存在错误的解决方法

我来帮你搞定这个问题，这个场景我之前处理过好几次了！

首先得搞清楚为啥会报错：你挂载PVC时用了subPath: postgres，这会把PVC里的空postgres子目录挂载到容器的/var/lib/postgresql/data路径下，直接覆盖了容器原本自带的、包含postgresql.conf等配置文件的目录。Postgres启动时找不到配置文件，自然就失败了。

给你两个靠谱的解决方案，看你的需求选：

方案一：移除subPath配置（推荐给新部署的情况） #

如果不需要在PVC里拆分多个子目录存不同数据，直接删掉subPath就行。这样整个PVC会挂载到/var/lib/postgresql/data，Postgres首次启动时会自动在这个目录里初始化所有需要的配置文件和数据结构。

修改后的Deployment里的volumeMounts部分是这样的：

volumeMounts:
  - name: postgres-storage
    mountPath: /var/lib/postgresql/data

改完后重新应用配置：

kubectl apply -f your-deployment-file.yaml

这个方法最简单，省事儿还不容易出错，适合第一次部署Postgres的场景。

方案二：手动初始化PVC的postgres子目录（适合必须用subPath的情况） #

如果你因为已有数据或者其他原因必须用subPath，那得先给PVC里的postgres目录补上Postgres需要的配置文件。可以用一个临时Pod来完成初始化：

1. 先写一个临时Pod的配置文件（比如叫postgres-init-pod.yaml）：

apiVersion: v1
kind: Pod
metadata:
  name: postgres-init
spec:
  volumes:
    - name: postgres-storage
      persistentVolumeClaim:
        claimName: postgres-persistent-volume-claim
  containers:
    - name: postgres-init
      image: prikshet/postgres
      command: ["bash", "-c", "mkdir -p /var/lib/postgresql/data/postgres && cp -R /usr/local/share/postgresql/* /var/lib/postgresql/data/postgres/ && chown -R postgres:postgres /var/lib/postgresql/data/postgres"]
      volumeMounts:
        - name: postgres-storage
          mountPath: /var/lib/postgresql/data

2. 应用这个临时Pod：

kubectl apply -f postgres-init-pod.yaml

3. 等Pod执行完自动退出后，删掉它：

kubectl delete pod postgres-init

4. 再重新应用你原来的Deployment配置（保留subPath），这次Postgres就能找到配置文件正常启动了。

额外提醒一下 #

• Postgres官方镜像的逻辑是：首次启动如果发现数据目录是空的，会自动初始化配置和数据库。但你挂载空的subPath目录后，容器会认为数据目录已经存在（哪怕是空的），所以不会触发自动初始化，这就是为啥要手动复制配置或者用方案一让它在挂载的根目录初始化。
• 先确认你的PVC已经成功绑定到Persistent Volume了，用这个命令查：kubectl get pvc postgres-persistent-volume-claim，状态要是Bound才对。

内容的提问来源于stack exchange，提问作者zendevil.eth