miraitechno/postgresql

docker-postgresql

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

镜像概述和主要用途

该Docker镜像用于创建和运行PostgreSQL数据库容器，提供便捷的数据库部署方案。通过容器化方式，简化PostgreSQL的安装与配置流程，支持数据持久化、自定义用户与数据库设置，以及多容器链接使用，适用于开发、测试及生产环境的数据库服务需求。

核心功能和特性

• 数据持久化：数据库数据存储在容器内/data卷，可映射到主机目录实现数据独立于容器生命周期
• 日志暴露：提供/var/log/postgresql卷，便于查看和管理PostgreSQL日志
• 环境变量配置：支持通过环境变量设置超级用户名(USER)、密码(PASS)及数据库名(DB)
• 灵活部署：支持自定义端口映射、数据目录及用户认证信息
• 容器链接：可与其他应用容器链接，通过环境变量自动传递数据库连接信息

使用场景和适用范围

• 开发环境快速搭建独立PostgreSQL实例
• 测试环境中需要隔离的数据库服务
• 微服务架构下与应用容器分离的数据库部署
• 需要便捷配置和迁移的数据库环境

详细使用方法和配置说明

镜像创建

基本构建

使用以下命令构建镜像，默认标签为paintedfox/postgresql：

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

使用Make构建

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

bash
$ make

自定义Docker用户名

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

bash
$ make DOCKER_USER=paintedfox

容器创建与运行

基本运行命令

bash
$ 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="$(mkpasswd -l 16)" \  # 生成16位密码
             miraitechno/postgresql

使用Make运行

若安装了make，可简化运行：

bash
$ make run

自定义配置运行

指定自定义端口、数据目录和用户信息：

bash
$ 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)  # 使用pwgen生成随机密码

环境变量说明

连接数据库

安装客户端

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

bash
$ sudo apt-get install postgresql-client

获取登录信息

查看容器日志获取数据库连接信息：

bash
$ docker logs postgresql
POSTGRES_USER=super
POSTGRES_PASS=b2rXEpToTRoK8PBx  # 示例密码
POSTGRES_DATA_DIR=/data
Starting PostgreSQL...
...

连接命令

使用获取的用户名和密码连接数据库：

bash
$ psql -h 127.0.0.1 -U super template1

容器链接使用

创建链接容器

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

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

--link postgresql:db参数将数据库容器别名为db，便于应用容器引用。

在链接容器中连接数据库

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

bash
$ 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：数据库容器端口