Kubernetes Pod定义中运行Postgres命令无法生效问题咨询

问题原因 #

• 覆盖了官方镜像默认启动逻辑：官方postgres镜像的默认入口命令会完成初始化并启动postgres服务进程，你自定义的command字段直接将启动命令替换为psql，导致postgres服务根本没有运行，自然无法建立连接。你手动exec进入Pod时能执行成功，是因为此时Pod已经按默认逻辑启动了postgres进程。
• 命令语法解析错误：你在args中使用了管道符|，这是Shell专属的语法，直接写在args数组中时，Kubernetes会将管道符及后续内容全部当成psql的参数传递，不会按Shell逻辑解析执行，因此你写的-h localhost等连接参数根本没有被第二条psql命令正确识别。

解决方案 #

推荐方案：使用官方镜像内置的初始化脚本机制 #

官方postgres镜像默认会在首次启动时，自动执行/docker-entrypoint-initdb.d/目录下的所有.sql/.sh脚本，完全不需要修改默认启动命令，是最稳定的实现方式：

1. 新建ConfigMap存储初始化脚本：

apiVersion: v1
kind: ConfigMap
metadata:
  name: postgres-init-script
data:
  init-db.sh: |
    #!/bin/bash
    set -e
    psql -U postgres -tc "SELECT 1 FROM pg_database WHERE datname = 'dominion'" | grep -q 1 || psql -U postgres -c "CREATE DATABASE dominion"

2. 修改Deployment的containers配置，新增脚本挂载：

containers:
    - name: postgres-container
      image: postgres
      imagePullPolicy: Always
      volumeMounts:
        - name: postgres-internal-volume
          mountPath: /var/lib/postgresql/data
          subPath: postgres
        # 新增初始化脚本挂载
        - name: init-script
          mountPath: /docker-entrypoint-initdb.d/
      envFrom:
        - configMapRef:
            name: postgres-internal-cnf
      ports:
        - containerPort: 5432
      # 删掉你自定义的command和args字段，恢复镜像默认启动逻辑
volumes:
  # 原有PVC配置保留
  - name: postgres-internal-volume
    persistentVolumeClaim:
      claimName: 你原有PVC的名称
  # 新增初始化脚本卷
  - name: init-script
    configMap:
      name: postgres-init-script

备用方案：手动包装Shell执行逻辑 #

如果你坚持要在command中直接写建库逻辑，需要用Shell包装整个执行流程，先启动postgres服务再执行建库命令：

containers:
    - name: postgres-container
      image: postgres
      imagePullPolicy: Always
      volumeMounts:
        - name: postgres-internal-volume
          mountPath: /var/lib/postgresql/data
          subPath: postgres
      envFrom:
        - configMapRef:
            name: postgres-internal-cnf
      ports:
        - containerPort: 5432
      command: ["/bin/bash", "-c"]
      args:
        - |
          # 后台启动postgres服务
          docker-entrypoint.sh postgres &
          # 等待服务启动完成
          until pg_isready -U postgres; do
            sleep 1
          done
          # 执行建库逻辑
          psql -U postgres -tc "SELECT 1 FROM pg_database WHERE datname = 'dominion'" | grep -q 1 || psql -h localhost -p 5432 -U postgres -c "CREATE DATABASE dominion"
          # 挂起避免容器退出
          wait

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