arxcf/pgclient

镜像概述

该Docker镜像为轻量级空容器，预装了postgresql-client（PostgreSQL数据库客户端）、jq（JSON数据处理工具）和curl（HTTP请求工具），旨在提供一个便捷的环境，用于快速执行数据库操作、JSON数据解析及HTTP请求等任务。

核心功能与特性

• postgresql-client：提供psql等命令行工具，支持连接PostgreSQL数据库、执行SQL查询、数据导入导出等操作。
• jq：轻量级JSON处理器，支持JSON数据的解析、过滤、转换和格式化，适用于处理API返回数据或配置文件。
• curl：命令行HTTP客户端，支持GET、POST等HTTP方法，可用于API测试、文件下载、服务健康检查等场景。
• 轻量级：基于空容器构建，体积小巧，启动快速，适合临时任务或作为基础镜像扩展。

使用场景

• 开发环境中临时执行PostgreSQL数据库操作（如数据查询、备份）。
• 处理JSON格式数据（如解析API响应、转换配置文件）。
• 测试HTTP接口或下载资源。
• 作为基础镜像，在其之上添加自定义脚本或工具，构建专用数据处理容器。

使用方法

基本使用

通过docker run命令启动容器，直接使用预装工具：

bash
# 启动容器并进入交互模式
docker run -it --rm [镜像名称] sh

# 在容器内使用工具示例
# 1. 使用curl发送HTTP请求
curl https://api.example.com/data

# 2. 使用jq解析JSON（假设已有JSON数据文件data.json）
jq '.results' data.json

# 3. 使用psql连接PostgreSQL数据库
psql -h [数据库主机] -p [端口] -U [用户名] -d [数据库名]

挂载数据卷（可选）

如需持久化数据或访问宿主机文件，可通过-v参数挂载数据卷：

bash
# 挂载宿主机当前目录到容器的/data目录
docker run -it --rm -v $(pwd):/data [镜像名称] sh

# 在容器内访问宿主机文件
cd /data
jq '.key' config.json  # 处理宿主机的config.json文件

环境变量配置（可选）

可通过环境变量预设数据库连接信息，简化命令：

bash
# 设置环境变量后启动容器
docker run -it --rm \
  -e PG_HOST=db.example.com \
  -e PG_PORT=5432 \
  -e PG_USER=admin \
  -e PG_DB=mydb \
  [镜像名称] \
  sh -c 'psql -h $PG_HOST -p $PG_PORT -U $PG_USER -d $PG_DB'

注意事项

• 该镜像为基础工具容器，不含持久化存储，敏感数据（如数据库密码）建议通过环境变量或外部配置文件传入。
• 使用psql时需确保目标PostgreSQL数据库允许远程连接（配置pg_hba.conf）。
• 如需扩展功能，可基于此镜像构建新镜像，添加额外工具或脚本。