paintedfox/postgresql

docker-postgresql

一个生成可运行PostgreSQL的容器的Dockerfile。

镜像概述和主要用途

该Docker镜像用于创建和运行PostgreSQL数据库容器，支持数据持久化存储、自定义用户配置及容器链接功能，适用于开发、测试和生产环境中快速部署PostgreSQL服务。

核心功能和特性

• 数据持久化：通过卷挂载将数据库数据存储在主机，确保数据独立于容器生命周期
• 自定义配置：支持通过环境变量设置超级用户名、密码及初始数据库
• 日志暴露：提供/var/log/postgresql卷用于访问PostgreSQL日志
• 容器链接：支持与其他容器链接，通过环境变量自动传递数据库连接信息

镜像创建

基本构建

使用以下命令构建镜像，标签可自定义（示例中为paintedfox/postgresql）：

$ docker build -t="paintedfox/postgresql" .

使用Makefile构建

若系统安装了make，可直接运行：

$ make

自定义Docker用户名

指定自定义Docker用户名构建：

$ make DOCKER_USER=paintedfox

容器创建与运行

基本运行命令

shell
$ mkdir -p /tmp/postgresql
$ docker run -d --name="postgresql" \
             -p 127.0.0.1:5432:5432 \
             -v /tmp/postgresql:/data \
             -e USER="super" \
             -e DB="database_name" \
             -e PASS="$(pwgen -s -1 16)" \
             paintedfox/postgresql

使用Makefile运行

若安装了make，可简化为：

shell
$ make run

自定义参数运行

指定主机端口、数据目录及用户信息：

shell
$ sudo mkdir -p /srv/docker/postgresql
$ make run PORT=127.0.0.1:5432 \
           DATA_DIR=/srv/docker/postgresql \
           USER=super \
           PASS=$(pwgen -s -1 16)

参数说明：

• -p：端口映射，格式为主机IP:主机端口:容器端口
• -v：卷挂载，将主机目录映射到容器/data（数据存储）
• -e USER：超级用户名（默认随机生成）
• -e PASS：超级用户密码（默认随机生成）
• -e DB：自动创建的数据库名（可选）

连接数据库

安装客户端

在Ubuntu 12.04LTS主机上安装PostgreSQL客户端：

shell
$ sudo apt-get install postgresql-client

获取登录凭据

通过容器日志查看自动生成的用户名和密码：

shell
$ docker logs postgresql
POSTGRES_USER=super
POSTGRES_PASS=b2rXEpToTRoK8PBx
POSTGRES_DATA_DIR=/data
Starting PostgreSQL...
...

连接命令

使用获取的凭据连接数据库：

shell
$ psql -h 127.0.0.1 -U super template1

容器链接

创建链接容器

将应用容器链接到数据库容器（假设数据库容器名为postgresql）：

shell
$ docker run -t -i --link postgresql:db ubuntu bash

在链接容器中连接数据库

在链接容器内安装客户端并连接：

shell
$ apt-get install -y postgresql-client
$ psql -U "$DB_ENV_USER" \
       -h "$DB_PORT_5432_TCP_ADDR" \
       -p "$DB_PORT_5432_TCP_PORT"

环境变量说明：

链接容器会自动获取以下环境变量（前缀DB_ENV_对应链接别名为db）：

• DB_ENV_USER：数据库超级用户名
• DB_ENV_PASS：数据库超级用户密码
• DB_PORT_5432_TCP_ADDR：数据库容器IP地址
• DB_PORT_5432_TCP_PORT：数据库容器端口

使用场景和适用范围

• 开发环境：快速搭建独立的PostgreSQL实例，支持数据持久化
• 测试环境：可重复部署的数据库环境，便于测试不同配置
• 微服务架构：作为独立数据服务与其他应用容器链接使用
• CI/CD流程：集成到自动化部署流程，提供临时数据库服务