如何在Helm部署的PostgreSQL中执行SQL脚本文件

问题背景 #

使用Helm部署Bitnami PostgreSQL，已在values.yaml中配置数据库凭证：

global:
  postgresql:
    auth:
      # Added below credentials for testing
      postgresPassword: "postgresqladmin"
      username: "admin"
      password: "admin"
      database: "postgresqlDB"
containerPorts:
  postgresql: 5432
image:
  registry: docker.io
  repository: bitnami/postgresql
  tag: 15.4.0-debian-11-r10
  digest: ""
  pullPolicy: IfNotPresent
  debug: false

尝试通过临时Pod连接数据库并执行SQL脚本时，执行以下命令报错：

helm upgrade --install postgresql -f values.yaml bitnami/postgresql
kubectl run postgresql-client --rm --tty -i --restart='Never' \
--image bitnami/postgresql --env="PGPASSWORD=admin" && \
kubectl cp ./create.sql postgresql-client:/create.sql && \
psql --host postgresql -U admin -d postgresqlDB -p 5432 -f /create.sql

报错信息：

The POSTGRESQL_PASSWORD environment variable is empty or not set. Set the environment variable ALLOW_EMPTY_PASSWORD=yes to allow the container to be started with blank passwords. This is recommended only for development.

错误原因 #

Bitnami官方的PostgreSQL镜像默认启动脚本会检查POSTGRESQL_PASSWORD环境变量，用于初始化数据库实例。但我们仅需用该镜像作为客户端连接已部署的PostgreSQL服务，不需要初始化新数据库，因此默认启动逻辑触发了报错。

正确解决方案 #

方案1：直接执行SQL语句（修正版） #

使用--command --跳过镜像默认启动脚本，直接执行psql命令：

kubectl run postgresql-client --rm --tty -i \
--restart='Never' --image "docker.io/bitnami/postgresql:15.4.0-debian-11-r10" \
--env="PGPASSWORD=admin" --command -- \
psql --host postgresql -U admin -d postgresqlDB -p 5432 -c "CREATE TABLE my_table ( \
id serial PRIMARY KEY,\
field VARCHAR(255)\
);"

注意：用-c参数传递SQL语句，避免直接拼接字符串导致的语法问题。

方案2：执行本地create.sql脚本 #

分步操作（无需多终端）

1. 启动临时客户端Pod（后台运行以便后续操作）：

kubectl run postgresql-client --restart='Never' \
--image "docker.io/bitnami/postgresql:15.4.0-debian-11-r10" \
--env="PGPASSWORD=admin" --env="ALLOW_EMPTY_PASSWORD=yes" --command -- sleep infinity

设置ALLOW_EMPTY_PASSWORD=yes允许容器启动（仅开发环境可用）。

2. 拷贝本地create.sql到Pod内：

kubectl cp ./create.sql postgresql-client:/create.sql

3. 在Pod中执行脚本：

kubectl exec -it postgresql-client -- \
psql --host postgresql -U admin -d postgresqlDB -p 5432 -f /create.sql

4. 执行完成后删除临时Pod：

kubectl delete pod postgresql-client

单命令简化版

如果需要一次性完成操作，可将步骤合并：

kubectl run postgresql-client --rm --restart='Never' \
--image "docker.io/bitnami/postgresql:15.4.0-debian-11-r10" \
--env="PGPASSWORD=admin" --env="ALLOW_EMPTY_PASSWORD=yes" --command -- bash -c "\
cp /dev/stdin /create.sql && \
psql --host postgresql -U admin -d postgresqlDB -p 5432 -f /create.sql" < ./create.sql

通过重定向将本地脚本内容传入Pod内执行，无需单独拷贝文件。

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