如何在Init Container中挂载SQL文件初始化PostgreSQL数据库

一、解决emptyDir挂载SQL文件失败的问题 #

emptyDir是Pod级别的临时存储，无法直接加载本地主机的SQL文件。正确的做法是将SQL脚本存入ConfigMap（存储普通脚本）或Secret（存储含敏感信息的脚本），再挂载到Init Container中：

1. 创建存储SQL脚本的ConfigMap #

假设你的初始化脚本是init-db.sql，执行以下命令创建ConfigMap：

kubectl create configmap postgres-init-scripts --from-file=init-db.sql

2. 在Deployment中挂载ConfigMap到Init Container #

将ConfigMap挂载为文件到Init Container的指定目录，示例中挂载到/scripts/：

二、SQL脚本中使用环境变量传递凭证 #

有两种可靠方法实现SQL脚本的环境变量替换：

方法1：使用psql内置变量替换 #

psql支持通过-v参数传递变量，SQL脚本中用:变量名引用：

• 脚本init-db.sql内容：

CREATE DATABASE IF NOT EXISTS :DB_NAME;
CREATE USER IF NOT EXISTS :DB_USER WITH PASSWORD :DB_PASSWORD;
GRANT ALL PRIVILEGES ON DATABASE :DB_NAME TO :DB_USER;

• Init Container命令中通过psql -v传入环境变量：

psql -h postgres-service -U postgres -v DB_USER=$DB_USER -v DB_PASSWORD=$DB_PASSWORD -v DB_NAME=$DB_NAME -f /scripts/init-db.sql

方法2：用envsubst预替换脚本占位符 #

如果脚本中有大量环境变量，可先用envsubst替换占位符再执行：

• 脚本init-db.sql内容（用${变量名}作为占位符）：

CREATE DATABASE IF NOT EXISTS ${DB_NAME};
CREATE USER IF NOT EXISTS ${DB_USER} WITH PASSWORD '${DB_PASSWORD}';
GRANT ALL PRIVILEGES ON DATABASE ${DB_NAME} TO ${DB_USER};

• Init Container命令中先替换再执行：

envsubst < /scripts/init-db.sql | psql -h postgres-service -U postgres

注意：密码用单引号包裹，避免特殊字符引发SQL语法错误。

三、完整的Deployment示例 #

apiVersion: apps/v1
kind: Deployment
metadata:
  name: your-app
spec:
  replicas: 1
  selector:
    matchLabels:
      app: your-app
  template:
    metadata:
      labels:
        app: your-app
    spec:
      initContainers:
      - name: postgres-init
        image: postgres:15-alpine
        env:
        - name: DB_USER
          valueFrom:
            secretKeyRef:
              name: postgres-credentials
              key: app-username
        - name: DB_PASSWORD
          valueFrom:
            secretKeyRef:
              name: postgres-credentials
              key: app-password
        - name: DB_NAME
          value: "your_app_db"
        - name: PGUSER
          value: "postgres"
        - name: PGPASSWORD
          valueFrom:
            secretKeyRef:
              name: postgres-credentials
              key: superuser-password
        command: ["/bin/sh", "-c"]
        args:
        - envsubst < /scripts/init-db.sql | psql -h postgres-service -d postgres;
        volumeMounts:
        - name: init-scripts
          mountPath: /scripts
      containers:
      - name: your-app-container
        image: your-app-image:latest
        # 应用容器配置（端口、环境变量等）
      volumes:
      - name: init-scripts
        configMap:
          name: postgres-init-scripts

额外注意事项 #

• 敏感信息（如密码）必须用Secret存储，通过valueFrom.secretKeyRef引用，禁止硬编码。
• 确保Init Container能访问PostgreSQL服务，检查服务名称、网络策略是否配置正确。
• 若需执行多个脚本，可将多个SQL文件存入ConfigMap，挂载后用循环执行：

  for file in /scripts/*.sql; do envsubst < $file | psql -h postgres-service -U postgres; done
  

内容的提问来源于stack exchange，提问作者kostas.kapasakis