andreswebs/postgresql-client

postgresql-client Docker镜像文档

镜像概述和主要用途

postgresql-client是一个轻量级Docker镜像，内置PostgreSQL客户端工具（psql），适用于本地Docker环境和Kubernetes集群。该镜像旨在提供便捷的数据库连接方式，方便用户在容器化环境中执行PostgreSQL数据库的查询、管理及维护操作。

核心功能和特性

• 轻量级设计：基于精简基础镜像构建，体积小，资源占用低
• 完整工具链：包含psql客户端，支持所有标准PostgreSQL命令
• 多环境兼容：同时支持本地Docker运行和Kubernetes集群部署
• 便捷操作：提供简单直观的命令行接口，快速建立数据库连接

使用场景和适用范围

• 本地开发测试：开发者快速连接本地或远程PostgreSQL数据库进行调试
• Kubernetes集群管理：在容器化生产环境中执行数据库查询、数据导出/导入等操作
• 自动化流程集成：作为CI/CD管道的一部分，执行数据库迁移或验证任务

使用方法和配置说明

本地运行

连接PostgreSQL数据库

通过以下命令启动容器并直接连接数据库：

bash
docker run --rm -it --name postgresql-client andreswebs/postgresql-client -h <host_ip_address> -p <port> -U <user> -W

参数说明：

• --rm：容器退出后自动删除
• -it：启用交互式终端
• --name：指定容器名称为postgresql-client
• -h：目标PostgreSQL数据库的主机IP地址
• -p：数据库端口（默认5432，可省略）
• -U：数据库登录用户名
• -W：强制提示输入密码

进入运行中的容器

如需在容器内执行额外操作，可通过以下命令进入容器shell：

bash
docker exec -it postgresql-client /bin/sh

Kubernetes环境运行

前提条件

• 已部署并正常运行的Kubernetes集群
• 已配置好的kubectl命令行工具（需具有集群操作权限）

部署镜像

使用以下命令部署PostgreSQL客户端到Kubernetes集群：

bash
kubectl apply -f postgresql-client.yml

注：postgresql-client.yml为包含Pod或Deployment定义的Kubernetes配置文件，需提前准备

附加到运行中的Pod

部署完成后，通过以下命令连接到运行中的Pod：

bash
kubectl attach --namespace=postgresql-client -ti postgresql-client

参数说明：

• --namespace：指定命名空间（需替换为实际使用的命名空间）
• -ti：启用交互式终端

连接PostgreSQL数据库

在Pod内使用psql命令连接目标数据库：

bash
psql -h <host_ip_address> -p <port> -U <user> -W

作者

Andre Silva

许可证

本项目采用Unlicense许可证。