ryanaross/postgres

轻量级PostgreSQL与MinIO客户端镜像

镜像概述

本镜像为最小化设计，集成了PostgreSQL客户端（psql）和MinIO客户端（mc），旨在提供轻量级工具集，满足数据库交互与对象存储管理需求。镜像体积小巧，适合资源受限环境或需要快速部署工具的场景。

核心功能与特性

• 多工具集成：包含PostgreSQL官方客户端（psql）和MinIO官方客户端（mc）
• 最小化设计：基于轻量级基础镜像构建，减少资源占用
• 即开即用：无需额外安装依赖，直接使用psql和mc命令
• 兼容性：支持标准PostgreSQL协议和MinIO S3兼容接口

使用场景

• 数据库日常维护：执行SQL查询、数据备份与恢复
• 对象存储管理：MinIO桶操作、文件上传/下载、权限配置
• CI/CD流程：集成到自动化流水线中，完成数据迁移或存储操作
• 临时工具环境：快速部署客户端工具，无需在主机安装完整依赖

使用方法与配置说明

基础使用

通过docker run命令直接使用客户端工具：

bash
# 查看PostgreSQL客户端版本
docker run --rm your-image-name psql --version

# 查看MinIO客户端版本
docker run --rm your-image-name mc --version

连接PostgreSQL数据库

bash
docker run --rm -it your-image-name psql -h [数据库主机] -p [端口] -U [用户名] -d [数据库名]

参数说明：

• -h：数据库主机地址
• -p：数据库端口（默认5432）
• -U：数据库用户名
• -d：目标数据库名

管理MinIO对象存储

bash
# 配置MinIO服务端连接
docker run --rm your-image-name mc config host add myminio [MinIO服务地址] [AccessKey] [SecretKey]

# 列出MinIO桶
docker run --rm your-image-name mc ls myminio

# 上传文件到MinIO
docker run --rm -v /本地文件路径:/data your-image-name mc cp /data/local-file.txt myminio/mybucket/

数据持久化

如需保存客户端配置（如MinIO连接信息），可挂载配置目录：

bash
docker run --rm -v /本地配置目录:/root/.mc your-image-name mc config host list

环境变量（可选）

如镜像支持，可通过环境变量预设常用配置：

• PG_HOST： PG_PORT PG_USER PG_DB：预设PostgreSQL连接参数
• MINIO_ENDPOINT MINIO_ACCESS_KEY MINIO_SECRET_KEY：预设MinIO连接参数

（注：具体环境变量支持需以镜像实际实现为准）