tmaxopensql/postgres

Tmax OpenSQL-PostgreSQL 镜像文档

镜像概述

Tmax OpenSQL是韩国领先DBMS公司TmaxTibero的开源DBMS专业服务平台品牌，基于其20年积累的自主技术，提供PostgreSQL一站式整体服务。OpenSQL-PostgreSQL镜像则是该平台下的Docker化部署方案，旨在简化PostgreSQL数据库的部署与管理，适用于对高可用性、可扩展性、大容量处理、备份恢复、安全性等有需求的业务场景。

TmaxTibero凭借24*365技术支持、7000+定制化数据库迁移咨询经验、152项专利技术及250人左右的研发团队，为该镜像提供了专业的技术背书。

支持的标签及Dockerfile

该镜像支持以下标签，均基于redhat/ubi8构建：

• 14.0：基于PostgreSQL 14.0
• 14.1：基于PostgreSQL 14.1
• 14.2：基于PostgreSQL 14.2
• 14.3：基于PostgreSQL 14.3
• 14.4：基于PostgreSQL 14.4
• 14.5：基于PostgreSQL 14.5
• 14.6：基于PostgreSQL 14.6

如何使用Tmax OpenSQL-PG镜像

基本运行命令

bash
docker run -v [主机绝对路径]:[容器内绝对路径] \
           --name [容器名称] \
           hypersql/postgres:[标签名称]

自定义PostgreSQL实例

通过vars.yml设置变量

将vars.yml文件或vars目录挂载到容器中，容器创建时会自动应用参数配置：

bash
# 挂载单个vars.yml文件
docker run -v /绝对路径/to/var/file:/tmp/settings/vars/vars.yml

# 挂载vars目录
docker run -v /绝对路径/to/vars/directory:/tmp/settings/vars

编辑vars.yml

可配置参数涵盖autotuning、manage_dbserver、init_dbserver角色相关参数（详细参数参考pg-ansible项目各角色README：https://github.com/hypersql/pg-ansible%EF%BC%89%E3%80%82%E5%B8%B8%E7%94%A8%E5%8F%82%E6%95%B0%E5%A6%82%E4%B8%8B%EF%BC%9A

设置超级用户名（默认：postgres）

yaml
pg_superuser: "super_username"

设置超级用户密码（必填）

yaml
pg_superuser_password: "xxxxx"

设置UID

yaml
pg_owner_id: 1000

设置GID

yaml
pg_group_id: 1000

设置数据库集群目录（默认：/var/lib/pgsql/version/data）

yaml
pg_data: "/pgdata"

设置日志目录（默认：/var/log/postgres）

yaml
pg_log: "/pglog"

设置WAL目录（默认：$PGDATA/pg_wal）

yaml
pg_wal: "/pgwal"

创建数据库

yaml
pg_databases:
  - name: "database_name"
    owner: "super_username"

设置PostgreSQL参数

yaml
pg_postgres_conf_params:
  - name: "archive_command"
    value: "/bin/true"

设置最大连接数（默认：按CPU自动计算，最小值100）

yaml
pg_max_connections: 50

限制Docker容器资源

镜像会根据容器隔离的资源自动调优参数，可通过以下方式限制容器资源：

限制内存

bash
docker run --memory="300m"

限制CPU

• 指定CPU核心（例：仅使用0-2核心）

  bash
  docker run --cpuset-cpus="0-2"
  

• 设置CPU CFS配额和周期（周期默认***，即100ms）

  bash
  docker run --cpu-period=100000 --cpu-quota=50000
  

• 设置CPU使用率百分比（例：使用50% CPU）

  bash
  docker run --cpus=".5"
  

推荐的Docker卷挂载

直接挂载主机路径可能导致容器用户与主机用户权限冲突，且Docker卷存储在/var/lib/docker/volumes/路径下，便于管理。推荐使用Docker卷而非直接挂载路径。

查看卷路径

bash
docker volume inspect <卷名称>

创建Docker卷

bash
# 创建卷
docker volume create volume-1

# 使用卷运行容器
docker run -v volume-1:/path/want/to/mount

在docker-compose中创建卷

声明的卷可在其他容器中复用：

yaml
# docker-compose.yml
services:
  pg:
    image: hypersql/postgres:14.6
    ports:
      - "5432:5432"
    volumes:
      - volume-1:/path/want/to/mount

volumes:
  volume-1:

从旧镜像迁移用户

如需从旧版hypersql docker镜像迁移数据，需使用迁移镜像，指定旧环境参数：

bash
docker run -v /绝对路径/to/external/volume:/hypersql/pgdata/ \
           -v /绝对路径/to/external/volume:/hypersql/pgwal/ \
           -e POSTGRES_USER=${PG_USER} \
           -e POSTGRES_PASSWORD=${PG_PASSWORD} \
           -e POSTGRES_DB=${DB_NAME} \
           -e POSTGRES_DATADIR=${DATADIR} \
             hypersql/postgres:migration-14

迁移完成后，可使用新版镜像正常运行。

PostgreSQL自动调优参数

镜像基于以下规则自动调优PostgreSQL参数：

连接与内存参数

• max_connections：vcpus*4（至少100）或pg_max_connections配置值
• shared_buffers：
  • 不超过64GB
  • 内存<3GB：内存/8
  • 3GB≤内存<8GB：内存/4*0.75
  • 8GB≤内存<64GB：内存/4
  • 内存≥64GB：内存/24（至少16GB）
• work_mem：(总内存 - shared_buffers)/(pg_max_connections*16)
• maintenance_work_mem：不超过1024MB，(总内存 - shared_buffers)*15/100/autovacuum_max_workers
• effective_cache_size：shared_buffers + (sys_buffers_kb + sys_cached_kb + sys_slab_reclaimable_kb)/1024

WAL与检查点参数

• wal_compression："on"
• wal_log_hints："on"
• wal_buffers：64MB
• checkpoint_timeout：5min
• checkpoint_completion_target：0.9

性能与资源参数

• cpu_tuple_cost：0.03
• autovacuum_max_workers：5
• autovacuum_vacuum_cost_limit：3000
• idle_in_transaction_session_timeout：10min
• default_statistics_target：100
• hash_mem_multiplier：2.0