efrecon/postgres

具备HEALTHCHECK功能的PostgreSQL镜像

镜像概述和主要用途

该镜像旨在捕获PostgreSQL官方镜像的所有标签（包括当前、过去及未来的标签），并创建具有HEALTHCHECK能力的等效镜像。通过此镜像，用户可获得与官方PostgreSQL镜像相同标签的版本，同时内置健康检查功能。要查看可用标签，请参考官方https://hub.docker.com/_/postgres/%E3%80%82

核心功能和特性

• 自动构建所有标签：自动获取并构建PostgreSQL官方镜像的所有标签版本，确保与官方版本同步
• 内置HEALTHCHECK：在镜像中集成健康检查功能，便于容器健康状态监控
• 依赖官方库自动更新：与PostgreSQL官方库建立依赖关系，当官方镜像有更新时自动重建所有标签和镜像
• 高效资源利用：借助Docker层缓存机制，仅重建少量变更层，减少资源消耗
• 通用实现：实现方式具有通用性，可应用于其他Docker官方库镜像

使用场景和适用范围

• 需要对PostgreSQL容器进行健康状态监控的部署环境
• 希望使用官方PostgreSQL所有标签版本，同时需要健康检查功能的场景
• 需与官方PostgreSQL版本保持同步更新的开发、测试及生产环境

使用方法和配置说明

获取镜像

该镜像的标签与PostgreSQL官方镜像完全一致，可通过以下命令拉取特定版本：

bash
docker pull [镜像名称]:[标签]

（注：请将[镜像名称]替换为实际镜像名称，[标签]替换为所需PostgreSQL版本标签，如16-alpine、15等，标签列表可参考https://hub.docker.com/_/postgres/%EF%BC%89

运行容器

使用方式与官方PostgreSQL镜像类似，示例命令：

bash
docker run -d --name postgres-with-healthcheck \
  -e POSTGRES_PASSWORD=mysecretpassword \
  [镜像名称]:[标签]

健康检查验证

容器运行后，可通过以下命令检查健康状态：

bash
docker inspect --format '{{.State.Health.Status}}' postgres-with-healthcheck

若返回healthy，表示健康检查正常。

实现原理

该镜像通过劫持Docker Cloud的两个构建钩子（build和push）实现功能：

1. 钩子劫持：利用https://docs.docker.com/docker-cloud/builds/advanced/#custom-build-phase-hooks%EF%BC%8C%E8%A6%86%E7%9B%96%60build%60%E5%92%8C%60push%60%E8%BF%87%E7%A8%8B
2. 标签获取：钩子从https://github.com/docker-library/official-images/blob/master/library/postgres%E8%8E%B7%E5%8F%96%E5%BD%93%E5%89%8D%E6%89%80%E6%9C%89%E6%A0%87%E7%AD%BE%E5%88%97%E8%A1%A8
3. 依赖同步：建立与官方PostgreSQL库的依赖关系，当官方镜像更新时自动触发重建，确保所有标签版本同步更新

通过这种方式，镜像能够高效地维护与官方PostgreSQL的版本一致性，并添加必要的健康检查功能。