returnpath/psql

returnpath/psql

镜像概述

本镜像为预装PostgreSQL命令行客户端psql的基础容器，旨在帮助用户在容器化环境中便捷地连接和管理PostgreSQL数据库。

核心功能

• 提供官方PostgreSQL命令行工具psql
• 支持通过环境变量配置数据库连接参数（用户名、密码、主机、端口等）
• 兼容Docker和Kubernetes容器环境

使用场景

• Docker环境下临时执行PostgreSQL查询操作
• Kubernetes集群中进行数据库连接有效性测试
• 结合定时任务工具执行周期性数据库维护任务

配置说明

需通过以下环境变量配置数据库连接信息：

• PGUSER：数据库登录用户名
• PGPASSWORD：数据库登录密码
• PGDATABASE：目标数据库名称
• PGHOST：数据库服务主机地址
• PGPORT：数据库服务端口（默认5432）

部署示例

Docker部署

bash
docker run --rm -ti \
  -e PGUSER=your_db_user \
  -e PGPASSWORD=your_db_password \
  -e PGDATABASE=your_db_name \
  -e PGHOST=your_db_host \
  -e PGPORT=5432 \
returnpath/psql -c '\dS'

Kubernetes部署

1. 创建数据库凭证Secret（db-secret.yml）：

yaml
apiVersion: v1
kind: Secret
metadata:
  name: db-secret-name
  labels:
    environment: prod
type: Opaque
data:
  pguser: <base64编码的用户名>
  pgpassword: <base64编码的密码>
  pgdatabase: <base64编码的数据库名>
  pghost: <base64编码的主机地址>
  pgport: <base64编码的端口>

生成base64编码：echo -n '内容' | base64，替换占位符后执行kubectl apply -f db-secret.yml。

2. 创建ReplicationController测试Pod（psql-rc-test.yaml）：

yaml
apiVersion: v1
kind: ReplicationController
metadata:
  name: psql
spec:
  replicas: 1
  selector:
    name: psql-test
  template:
    metadata:
      labels:
        name: psql-test
        service: psql-test
    spec:
      containers:
      - name: psql-test
        image: returnpath/psql
        env:
        - name: PGUSER
          valueFrom:
            secretKeyRef:
              name: db-secret-name
              key: pguser
        - name: PGPASSWORD
          valueFrom:
            secretKeyRef:
              name: db-secret-name
              key: pgpassword
        - name: PGDATABASE
          valueFrom:
            secretKeyRef:
              name: db-secret-name
              key: pgdatabase
        - name: PGHOST
          valueFrom:
            secretKeyRef:
              name: db-secret-name
              key: pghost
        - name: PGPORT
          valueFrom:
            secretKeyRef:
              name: db-secret-name
              key: pgport
        args:
          - "-c"
          - "\\dS"
      restartPolicy: Always

执行kubectl apply -f psql-rc-test.yaml启动测试Pod。

许可证

本项目采用MIT许可证发布。上游工具psql遵循PostgreSQL许可证，awscli遵循Apache 2.0许可证。 ===END===