1maa/postgres

1maa/postgres:10-alpine

镜像概述

1maa/postgres:10-alpine是基于官方postgres:10-alpine镜像的扩展版本，在保留官方镜像核心功能的基础上，集成了额外的非contrib扩展，并调整了默认配置，以满足特定场景下对PostgreSQL扩展功能的需求。

核心功能与特性

额外非contrib扩展

该镜像包含以下额外的非contrib扩展：

• pgTAP
  https://github.com/theory/pgtap 是一个PostgreSQL单元测试框架，允许使用TAP（Test Anything Protocol）格式编写和运行数据库测试用例，便于自动化测试和持续集成。

• postgres-json-schema
  https://github.com/gavinwahl/postgres-json-schema 提供了对JSON Schema的支持，允许在PostgreSQL中验证JSON数据是否符合指定的JSON Schema规范。

默认配置调整

为增强日志记录能力，镜像默认调整了PostgreSQL配置：

log_statement = 'all'

该配置会记录所有SQL语句，便于调试和审计。

使用场景

适用于需要以下功能的PostgreSQL应用场景：

• 需要使用pgTAP进行数据库单元测试的开发或测试环境
• 需要对JSON数据进行JSON Schema验证的应用
• 需要详细记录SQL执行语句的调试或审计场景

使用方法

基本使用

可通过docker run命令直接启动容器，基本示例如下：

bash
docker run -d \
  --name postgres-10-extended \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -p 5432:5432 \
  1maa/postgres:10-alpine

环境变量

该镜像继承了官方postgres:10-alpine镜像的所有环境变量，常用环境变量包括：

数据持久化

为避免数据丢失，建议挂载数据卷到/var/lib/postgresql/data：

bash
docker run -d \
  --name postgres-10-extended \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v /local/path/to/data:/var/lib/postgresql/data \
  -p 5432:5432 \
  1maa/postgres:10-alpine

扩展启用

镜像中集成的扩展需手动启用，可通过SQL命令在数据库中创建扩展：

sql
-- 启用pgTAP
CREATE EXTENSION pgtap;

-- 启用postgres-json-schema
CREATE EXTENSION postgres_json_schema;

配置修改

若需调整默认配置（如log_statement），可通过挂载自定义postgresql.conf文件覆盖默认配置：

1. 本地创建自定义postgresql.conf（可基于容器内默认配置修改）
2. 启动容器时挂载配置文件：

bash
docker run -d \
  --name postgres-10-extended \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v /local/path/to/postgresql.conf:/var/lib/postgresql/data/postgresql.conf \
  -p 5432:5432 \
  1maa/postgres:10-alpine