Kubernetes部署PostgreSQL数据无法持久化问题排查求助

问题原因分析 #

• hostPath与GCP Kubernetes环境不兼容：hostPath依赖节点本地文件系统，虽然你将GCP磁盘挂载到节点目录，但Kubernetes的hostPath卷未关联GCP磁盘的持久化属性，且若Pod重新调度（哪怕单节点环境下重建），权限配置不当会导致容器无法写入实际挂载的磁盘。
• 容器权限不匹配：PostgreSQL镜像默认使用postgres用户（UID=999，GID=999）运行，但节点上的/var/lib/postgresql目录默认属于root用户，容器内用户无写入权限，实际数据会被写入容器临时存储层，而非挂载的GCP磁盘。
• PGDATA路径初始化冲突：你将卷挂载到/var/lib/postgresql，同时设置PGDATA=/var/lib/postgresql/data/pgdata，若挂载目录为空且权限不足，PostgreSQL初始化脚本会自动在容器内部临时路径创建新实例，而非使用持久化卷。

解决方案 #

方案1：使用GCP原生PersistentVolume（推荐） #

在GCP Kubernetes集群中，应使用GCP PersistentDisk（PD）作为持久化存储，通过动态PV创建（依赖集群默认StorageClass）：

1. 创建PostgreSQL的PVC：

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: postgres-pv-claim
spec:
  accessModes:
    - ReadWriteOnce
  resources:
    requests:
      storage: 10Gi

2. 修改PostgreSQL Deployment配置：
   添加安全上下文确保容器用户拥有写入权限：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: postgresql
  labels:
    app: postgresql
spec:
  replicas: 1
  selector:
    matchLabels:
      app: postgresql
  template:
    metadata:
      labels:
        app: postgresql
    spec:
      securityContext:
        fsGroup: 999  # 匹配postgres用户GID，确保卷权限正确
      containers:
        - image: docker.io/yamamuratkr/postgres
          name: postgresql
          env:
            - name: POSTGRES_USER
              valueFrom:
                secretKeyRef:
                  name: postgres
                  key: database_user
            - name: POSTGRES_PASSWORD
              valueFrom:
                secretKeyRef:
                  name: postgres
                  key: database_password
            - name: PGDATA
              value: "/var/lib/postgresql/data/pgdata"
          ports:
            - containerPort: 5432
              name: postgresql
          volumeMounts:
            - name: postgredb
              mountPath: /var/lib/postgresql
      volumes:
        - name: postgredb
          persistentVolumeClaim:
            claimName: postgres-pv-claim

方案2：修复hostPath权限（仅单节点测试用） #

若坚持使用hostPath，需手动调整节点目录权限：

1. 在GCP实例上执行命令：

sudo chown -R 999:999 /var/lib/postgresql
sudo chmod -R 700 /var/lib/postgresql

2. 为Deployment添加同方案1的securityContext配置，确保容器用户能访问挂载目录。

验证步骤 #

• 创建测试数据库和表，插入测试数据
• 删除PostgreSQL Pod：kubectl delete pod <postgres-pod-name>
• 等待Pod重建完成后，连接数据库检查数据是否保留

内容的提问来源于stack exchange，提问作者山村武