webhippie/postgresql

PostgreSQL Docker镜像

概述

这是运行在https://github.com/dockhippie/alpine上的PostgreSQL Docker镜像，用于便捷部署和运行PostgreSQL数据库服务，支持数据持久化、备份管理及配置自定义。

版本信息

可用版本请查看https://hub.docker.com/r/webhippie/postgresql/tags、Quay或https://github.com/dockhippie/postgresql中的现有文件夹。

卷（Volumes）

• /var/lib/postgresql: PostgreSQL数据存储目录
• /var/lib/backup: 备份文件存储目录
• /etc/postgresql/init.d: 初始化脚本目录（启动时执行）
• /etc/postgresql/conf.d: 配置文件目录（自定义配置）

端口（Ports）

• 5432: PostgreSQL服务默认端口

可用环境变量

console
POSTGRESQL_ADDITIONAL_HBA =          # 额外的pg_hba.conf配置
POSTGRESQL_ADDITIONAL_IDENT =        # 额外的ident配置
POSTGRESQL_AUTH_METHOD = md5         # 认证方法，默认md5
POSTGRESQL_BACKUP_IGNORE = (postgres|template0|template1)  # 备份时忽略的数据库
POSTGRESQL_BACKUP_PATH = /var/lib/backup  # 备份文件路径
POSTGRESQL_BACKUP_RETENTION = 14     # 备份保留天数，默认14天
POSTGRESQL_DATABASE = ${POSTGRESQL_USERNAME}  # 数据库名称，默认与用户名相同
POSTGRESQL_INITDB_LOCALE = en_US.UTF-8  # 初始化数据库的区域设置
POSTGRESQL_MAX_CONNECTIONS = 100     # 最大连接数，默认100
POSTGRESQL_PASSWORD = ${POSTGRESQL_ROOT_PASSWORD}  # 用户密码，默认与root密码相同
POSTGRESQL_ROOT_PASSWORD =           # PostgreSQL root用户密码（必填）
POSTGRESQL_SKIP_CHMOD = false        # 是否跳过权限修改，默认false
POSTGRESQL_SKIP_CHOWN = false        # 是否跳过所有者修改，默认false
POSTGRESQL_SKIP_MKDIR = false        # 是否跳过目录创建，默认false
POSTGRESQL_SUPERUSER_CONNECTIONS = 3 # 超级用户连接数，默认3
POSTGRESQL_USERNAME =                # 数据库用户名

通过命令提取：grep -hE ': "\$\{(.*)\}"' latest/overlay/etc/entrypoint.d/*.sh | sed 's/: "\${//' | sed 's/:="/ = /' | sed 's/"}"$//' | sort | uniq

继承的环境变量

• https://github.com/dockhippie/alpine#available-environment-variables

使用方法

基本运行示例

bash
docker run -d \
  --name postgresql \
  -p 5432:5432 \
  -v /path/to/postgresql/data:/var/lib/postgresql \
  -v /path/to/backups:/var/lib/backup \
  -e POSTGRESQL_ROOT_PASSWORD=mysecretpassword \
  -e POSTGRESQL_USERNAME=myuser \
  -e POSTGRESQL_PASSWORD=mypassword \
  -e POSTGRESQL_DATABASE=mydb \
  webhippie/postgresql

Docker Compose示例

yaml
version: '3'

services:
  postgresql:
    image: webhippie/postgresql
    container_name: postgresql
    ports:
      - "5432:5432"
    volumes:
      - postgresql-data:/var/lib/postgresql
      - postgresql-backup:/var/lib/backup
      - ./init-scripts:/etc/postgresql/init.d
      - ./conf.d:/etc/postgresql/conf.d
    environment:
      - POSTGRESQL_ROOT_PASSWORD=mysecretpassword
      - POSTGRESQL_USERNAME=myuser
      - POSTGRESQL_PASSWORD=mypassword
      - POSTGRESQL_DATABASE=mydb
      - POSTGRESQL_MAX_CONNECTIONS=200
    restart: unless-stopped

volumes:
  postgresql-data:
  postgresql-backup:

贡献

Fork -> 提交补丁 -> 推送 -> 拉取请求

作者

• https://github.com/tboerger

许可证

MIT

版权信息

console
Copyright (c) 2015 Thomas Boerger <http://www.webhippie.de>