goodrainapps/postgresql

PostgreSQL for ACP

PostgreSQL是功能强大的开源对象关系型数据库系统，拥有超过15年的活跃开发历史和成熟架构，以可靠性、数据完整性和正确性著称。它可运行于所有主流操作系统，包括Linux、UNIX（AIX、BSD、HP-UX、SGI IRIX、macOS、Solaris、Tru64）和Windows，完全符合ACID标准，全面支持外键、连接、视图、触发器和存储过程（多语言）。

!postgresql

支持的标签及Dockerfile链接

9.6 , 9.6.3 , latest https://github.com/goodrain-apps/docker-postgresql/blob/9.6/9.6/Dockerfile

9.5 , 9.5.7 https://github.com/goodrain-apps/docker-postgresql/blob/9.5/9.5/Dockerfile

9.4 , 9.4.12 https://github.com/goodrain-apps/docker-postgresql/blob/9.4/9.4/Dockerfile

9.3 , 9.3.17 https://github.com/goodrain-apps/docker-postgresql/blob/9.3/9.3/Dockerfile

关于本镜像

本镜像基于Alpine系统构建，可在Goodrain ACM中安装，完全兼容Goodrain ACP平台。

如何使用本镜像

通过ACM安装

![部署到ACP]([***]

通过Docker

安装

推荐通过hub.docker.com获取自动构建的镜像：

bash
docker pull goodrainapps/postgresql:9.4.12

也可手动构建镜像：

bash
https://github.com/goodrain-apps/docker-postgresql.git
cd docker-postgresql
git branch 9.4
make base
make build
make release

快速启动

运行PostgreSQL镜像：

bash
docker run -d --name postgresql goodrainapps/postgresql:9.4.12

以管理员用户postgres登录容器的最简单方式是使用docker exec命令连接到运行中的容器，并通过unix socket连接PostgreSQL服务器，postgres用户默认密码为pass4you：

bash
docker exec -it postgresql sudo -u postgres psql

数据持久化

为实现数据持久化，需将卷挂载到/usr/local/pgsql/data。更新后的运行命令如下：

bash
docker run -d --name postgresql \
-v ${PWD}/data:/usr/local/pgsql/data \
goodrainapps/postgresql:9.4.12

这将确保数据库数据在镜像停止和重启后不会丢失。

启动时创建用户和数据库

本镜像允许在首次启动时创建用户和数据库。

指定DB_USER和DB_PASS变量可创建新用户。以下命令将创建用户dbuser，密码为dbpass：

bash
docker run --name postgresql -d \
  -e 'DB_USER=dbuser' \
  -e 'DB_PASS=dbpass' \
  goodrainapps/postgresql:9.4.12

注意

• 若未指定密码，用户将使用默认密码pass4you
• 若用户已存在，则不做任何更改

同样，可通过DB_NAME变量指定数据库名称创建新数据库：

bash
docker run --name postgresql -d \
  -e 'DB_NAME=dbname' goodrainapps/postgresql:9.4.12

也可在DB_NAME变量中指定逗号分隔的数据库名称列表（此功能仅在9.1-1以上版本可用），创建多个数据库（如dbname1和dbname2）：

bash
docker run --name postgresql -d \
  -e 'DB_NAME=dbname1,dbname2' \
  goodrainapps/postgresql:9.4.12

若创建数据库时同时指定DB_USER和DB_PASS变量，该用户将被授予数据库访问权限。例如：

bash
docker run --name postgresql -d \
  -e 'DB_USER=dbuser' \
  -e 'DB_PASS=dbpass' \
  -e 'DB_NAME=dbname' \
  goodrainapps/postgresql:9.4.12

将创建用户dbuser（密码dbpass）和数据库dbname，且dbuser对dbname拥有完全访问权限。

PSQL_TRUST_LOCALNET环境变量可配置PostgreSQL信任同一网络的连接，便于其他容器无需认证即可连接。设置PSQL_TRUST_LOCALNET=true启用此功能：

bash
docker run --name postgresql -d \
  -e 'PSQL_TRUST_LOCALNET=true' \
  goodrainapps/postgresql:9.4.12

这将在pg_hba.conf文件中添加：

host    all             all             samenet                 trust

启用Unaccent（带重音的纯文本搜索）

Unaccent是一个文本搜索词典，可从词位中移除重音（变音符号）。它是过滤词典，输出会传递给下一个词典（若有），支持全文搜索的无重音处理。默认禁用，设置DB_UNACCENT=true启用：

bash
docker run --name postgresql -d \
  -e 'DB_UNACCENT=true' \
  goodrainapps/postgresql:9.4.12

环境变量

自定义postgresql.conf

本镜像支持启动容器时修改postgresql.conf配置项。默认设置如下：

bash
CFG_SSl=${CFG_SSl:-off}
CFG_TIMEZONE=${CFG_TIMEZONE:-Asia/Shanghai}
CFG_LOG_TIMEZONE=${CFG_LOG_TIMEZONE:-Asia/Shanghai}

启动容器时可通过环境变量指定配置（变量名需以CFG_开头），例如设置max_connections：

bash
docker run -d \
-e DB_PASS=abc123 \
-e DB_USER=goodrain \
-e DB_NAME=grtest \
-e DEBUG=1 \
-e CFG_MAX_CONNECTIONS=200  \
goodrainapps/postgresql:9.4.12