jobandtalent/postgres

postgresql-healthcheck

![Build Status]([***]

镜像概述

postgresql-healthcheck是基于官方PostgreSQL Alpine镜像构建的Docker镜像，核心特点是集成了健康检查功能，确保容器运行状态可被有效监控。该镜像保留了官方PostgreSQL镜像的所有功能特性，同时增强了容器健康状态的可观测性。

核心功能和特性

• 基于官方镜像：完全基于https://hub.docker.com/_/postgres%E6%9E%84%E5%BB%BA%EF%BC%8C%E7%BB%A7%E6%89%BF%E5%85%B6%E6%89%80%E6%9C%89%E5%8A%9F%E8%83%BD%E5%92%8C%E7%89%B9%E6%80%A7
• 健康检查集成：内置健康检查机制，支持容器编排平台（如Docker Compose、Kubernetes）监控数据库服务状态
• 轻量级：基于Alpine Linux构建，保持较小镜像体积
• 多版本支持：提供多个PostgreSQL版本的镜像标签选择

支持的标签

当前支持以下标签（基于官方PostgreSQL Alpine镜像版本）：

• 9.5-alpine
• 9.6-alpine
• 10.1-alpine
• 11.1-alpine
• 11.4-alpine
• 11.5-alpine
• 11.9-alpine
• 11.10-alpine
• 11.11-alpine
• 11.16-alpine
• 12.4-alpine
• 12.5-alpine
• 13.0-alpine
• 13.1-alpine
• 13.2-alpine
• 13.6-alpine
• 13.10-alpine
• 14.3-alpine
• 14.5-alpine
• 14.6-alpine
• 14.8-alpine
• 15.2-alpine
• 15.4-alpine

使用场景

• 容器编排环境（如Kubernetes、Docker Swarm）中需要健康检查的PostgreSQL部署
• 需监控数据库服务可用性的生产环境
• 自动化运维流程中需要验证数据库容器状态的场景
• 开发和测试环境中需要快速部署带健康检查的PostgreSQL实例

使用方法

基本使用

使用方式与官方PostgreSQL镜像基本一致，可通过以下命令启动容器：

bash
docker run -d \
  --name postgres-with-healthcheck \
  -e POSTGRES_PASSWORD=mysecretpassword \
  jobandtalent/postgres:15.4-alpine

Docker Compose示例

yaml
version: '3'
services:
  postgres:
    image: jobandtalent/postgres:15.4-alpine
    environment:
      POSTGRES_USER: myuser
      POSTGRES_PASSWORD: mypassword
      POSTGRES_DB: mydb
    volumes:
      - postgres-data:/var/lib/postgresql/data
    healthcheck:
      # 健康检查已内置，无需额外配置
      test: ["CMD-SHELL", "pg_isready -U myuser -d mydb"]
      interval: 10s
      timeout: 5s
      retries: 5

volumes:
  postgres-data:

配置说明

所有官方PostgreSQL镜像支持的环境变量、配置文件和数据持久化方式均适用于本镜像，主要包括：

• 环境变量：

  • POSTGRES_USER：数据库用户名
  • POSTGRES_PASSWORD：数据库密码
  • POSTGRES_DB：初始数据库名称
  • PGDATA：数据库数据存储路径（默认/var/lib/postgresql/data）

• 数据持久化：通过挂载卷到/var/lib/postgresql/data目录实现数据持久化

参考

有关详细使用方法，请参阅https://hub.docker.com/_/postgres?tab=description%E3%80%82