pbxx/pg_isready

pbxx/pg_isready 镜像说明

镜像概述

本镜像基于postgres:11-alpine构建，集成PostgreSQL官方工具pg_isready，专注于快速验证PostgreSQL数据库实例的可连接性。镜像采用Alpine Linux作为基础，具有体积小、启动速度快的特点，适合作为数据库健康检查或自动化流程中的验证工具。

核心功能

• 利用pg_isready工具检测PostgreSQL数据库的运行状态
• 支持通过命令行参数或环境变量配置数据库连接信息（主机、端口、用户等）
• 镜像体积轻量，资源占用低，适合批量部署或嵌入式场景

使用场景

• 数据库服务启动后的健康检查
• 自动化部署流程中验证数据库可用性
• 监控系统中定期检查数据库连接状态
• CI/CD流水线中确保数据库就绪后再执行后续步骤

配置说明

可通过以下两种方式配置连接参数：

1. 命令行参数：支持pg_isready标准参数，如-h（主机）、-p（端口）、-U（用户）、-d（数据库名）等。
2. 环境变量：支持PostgreSQL官方环境变量，如PGHOST、PGPORT、PGUSER、PGDATABASE等。

部署示例

直接使用命令行参数

bash
docker run pbxx/pg_isready -h db.example.com -p 5432 -U postgres

使用环境变量配置

bash
docker run -e PGHOST=db.example.com -e PGPORT=5432 -e PGUSER=postgres pbxx/pg_isready

Docker Compose示例（健康检查用）

yaml
version: '3'
services:
  db:
    image: postgres:11-alpine
    environment:
      POSTGRES_USER: postgres
      POSTGRES_PASSWORD: password
  check_db:
    image: pbxx/pg_isready
    environment:
      PGHOST: db
      PGUSER: postgres
      PGPASSWORD: password
    depends_on:
      - db