dimagi/docker-postgresql

PostgreSQL Docker Plus

镜像概述和主要用途

PostgreSQL Docker Plus 是基于官方 https://hub.docker.com/_/postgres/ 构建的增强版镜像，主要用途是在标准PostgreSQL功能基础上，集成额外插件以扩展数据库能力。

核心功能和特性

• pghashlib插件：集成自 https://github.com/markokr/pghashlib%EF%BC%8C%E6%8F%90%E4%BE%9B%E9%A2%9D%E5%A4%96%E7%9A%84%E5%93%88%E5%B8%8C%E5%87%BD%E6%95%B0%E6%94%AF%E6%8C%81%EF%BC%8C%E5%A2%9E%E5%BC%BA%E6%95%B0%E6%8D%AE%E5%BA%93%E7%9A%84%E5%93%88%E5%B8%8C%E8%AE%A1%E7%AE%97%E8%83%BD%E5%8A%9B%E3%80%82
• plproxy插件：集成自 https://plproxy.github.io/%EF%BC%8C%E6%94%AF%E6%8C%81%E5%88%86%E5%B8%83%E5%BC%8F%E6%9F%A5%E8%AF%A2%E4%BB%A3%E7%90%86%EF%BC%8C%E4%BE%BF%E4%BA%8E%E6%9E%84%E5%BB%BA%E5%88%86%E5%B8%83%E5%BC%8F%E6%95%B0%E6%8D%AE%E5%BA%93%E6%9E%B6%E6%9E%84%E3%80%82

使用场景和适用范围

适用于需要以下功能的PostgreSQL应用场景：

• 需要使用pghashlib提供的特殊哈希算法的业务系统
• 构建分布式数据库集群，需要通过plproxy实现跨节点查询代理的场景
• 对官方PostgreSQL镜像有插件扩展需求的开发或生产环境

详细使用方法和配置说明

创建新Postgres版本的Dockerhub镜像流程

当需要为新的PostgreSQL版本创建Dockerhub镜像时，按以下步骤操作：

1. 创建或检出对应PostgreSQL主版本的分支（例如：git checkout 14）
2. 更新Dockerfile中的PostgreSQL具体点版本（例如：14.3）
3. 按照下方手动构建流程构建镜像
4. 如需要，更新Dockerfile并重复上一步骤直至构建成功
5. 提交变更
6. 为点版本创建标签（例如：git tag 14.3）
7. 推送分支和标签（例如：git push; git push --tags）
8. 在 https://hub.docker.com/repository/registry-1.docker.io/dimagi/docker-postgresql/builds 验证构建任务是否已排队

手动构建

通过以下命令手动构建镜像：

sh
export tag=<version-tag>  # 指定版本标签，例如14.3
export base_image=dimagi/docker-postgresql
export image=$base_image:$tag

# 列出已存在的镜像
docker images "$base_image"

# （可选）强制移除旧容器和镜像
docker rm -fv "$image"
docker rmi "$image"

# 构建新镜像
docker build -t "$image" .