mongkok/postgres

PostgreSQL Docker镜像文档

镜像概述

本镜像基于PostgreSQL构建，提供便捷的数据库部署方案，支持数据库创建、用户管理、复制集群配置、快照及备份等功能，简化PostgreSQL数据库的部署与管理流程。

核心功能与特性

• 支持创建数据库及数据库用户
• 可安装PostgreSQL扩展（如PostGIS、hstore、uuid-ossp）
• 支持配置复制用户，实现主从复制架构
• 提供快照功能，便于数据状态保存
• 支持数据备份，保障数据安全
• 通过环境变量灵活配置，适应不同场景需求

使用场景

• 开发环境：快速部署PostgreSQL实例，用于应用开发与测试
• 测试环境：构建主从复制集群，验证应用高可用性
• 生产环境：部署可靠的PostgreSQL服务，支持数据备份与恢复
• 数据迁移：通过快照和备份功能实现数据迁移

使用方法

快速启动

创建数据库用户并启动PostgreSQL实例：

sh
sudo docker run --name pg.master -itd --restart always \
    --env 'POSTGRES_PASSWORD=pass' \  # PostgreSQL超级用户密码
    --env 'POSTGRES_DB_NAME=mydb' \   # 要创建的数据库名称
    --env 'POSTGRES_DB_USER=me' \     # 数据库用户名称
    --env 'POSTGRES_DB_PASS=db-pass' \ # 数据库用户密码
    --env 'POSTGRES_DB_EXTENSION=postgis,hstore,uuid-ossp' \ # 要安装的扩展
    mongkok/postgres:10

创建复制用户

配置用于主从复制的复制用户：

sh
sudo docker run --name pg.master -itd --restart always \
    --env 'REPLICATION_USER=replication-user' \ # 复制用户名称
    --env 'REPLICATION_PASS=replication-pass' \ # 复制用户密码
    mongkok/postgres:10

设置复制集群（从节点）

部署从节点以构建主从复制集群：

sh
docker run --name pg.slave -itd --restart always \
    --network postgres \  # 连接到包含主节点的网络
    --env 'REPLICATION_MODE=slave' \ # 复制模式：从节点
    --env 'REPLICATION_HOST=pg.master' \ # 主节点主机名
    --env 'REPLICATION_PORT=5432' \ # 主节点端口
    --env 'REPLICATION_USER=replication-user' \ # 复制用户名称
    --env 'REPLICATION_PASS=replication-pass' \ # 复制用户密码
    mongkok/postgres:10

创建快照

创建数据库快照：

sh
docker run --name pg.snapshot -itd --restart always \
    --network postgres \  # 连接到包含主节点的网络
    --env 'REPLICATION_MODE=snapshot' \ # 复制模式：快照
    --env 'REPLICATION_HOST=pg.master' \ # 主节点主机名
    --env 'REPLICATION_PORT=5432' \ # 主节点端口
    --env 'REPLICATION_USER=replication-user' \ # 复制用户名称
    --env 'REPLICATION_PASS=replication-pass' \ # 复制用户密码
    mongkok/postgres:10

创建备份

生成数据库备份文件：

sh
docker run --name pg.backup -it --rm \
    --network postgres \  # 连接到包含主节点的网络
    --env 'REPLICATION_MODE=backup' \ # 复制模式：备份
    --env 'REPLICATION_HOST=pg.master' \ # 主节点主机名
    --env 'REPLICATION_PORT=5432' \ # 主节点端口
    --env 'REPLICATION_USER=replication-user' \ # 复制用户名称
    --env 'REPLICATION_PASS=replication-pass' \ # 复制用户密码
    --volume /path/to/postgresql.$(date +%Y%m%d%H%M%S):/var/lib/postgresql/replica \ # 本地备份目录挂载
    mongkok/postgres:10

参考资源

• 官方PostgreSQL镜像

  • Docker Hub: https://hub.docker.com/_/postgres/
  • GitHub: https://github.com/docker-library/postgres

• PostGIS镜像

  • Docker Hub: https://hub.docker.com/r/mdillon/postgis/
  • GitHub: https://github.com/appropriate/docker-postgis

• 复制功能参考

  • Docker Hub: https://hub.docker.com/r/sameersbn/postgresq
  • GitHub: https://github.com/sameersbn/docker-postgresql