hicommonwealth/cw_postgres

Postgres扩展镜像文档

镜像概述和主要用途

本仓库的Docker镜像基于官方Postgres镜像构建，扩展了其功能，包含额外的Postgres扩展。旨在为用户提供开箱即用的、带有更多功能的Postgres数据库环境，满足需要特定扩展支持的应用场景。

核心功能和特性

• 基于官方镜像：继承官方Postgres镜像的所有功能和特性，确保稳定性和兼容性
• 额外扩展支持：包含官方镜像未默认提供的额外Postgres扩展（如PostGIS、pg_trgm、uuid-ossp等常见扩展，具体扩展列表可能因镜像版本而异）
• 无缝集成：使用方式与官方Postgres镜像一致，无需额外学习成本

使用场景和适用范围

• 需要Postgres数据库且依赖特定扩展功能的应用开发和测试环境
• 生产环境中需要使用额外Postgres扩展的场景
• 希望简化扩展安装流程，直接使用预配置扩展的数据库环境

使用方法和配置说明

拉取镜像

bash
docker pull [镜像仓库地址]/postgres-extended:[版本标签]

注：请将[镜像仓库地址]和[版本标签]替换为实际的仓库地址和版本号。

运行容器

基本运行命令：

bash
docker run -d \
  --name postgres-extended \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_DB=mydb \
  -p 5432:5432 \
  -v postgres-data:/var/lib/postgresql/data \
  [镜像仓库地址]/postgres-extended:[版本标签]

参数说明

• -e POSTGRES_PASSWORD：设置Postgres数据库超级用户密码（必填）
• -e POSTGRES_USER：设置Postgres数据库超级用户名（可选，默认值为postgres）
• -e POSTGRES_DB：设置默认数据库名称（可选，默认与POSTGRES_USER同名）
• -p 5432:5432：将容器内Postgres端口映射到主机端口
• -v postgres-data:/var/lib/postgresql/data：挂载数据卷，持久化数据库数据

验证扩展

容器启动后，可通过以下方式验证扩展是否已安装：

1. 进入容器：

bash
docker exec -it postgres-extended psql -U myuser -d mydb

2. 在Postgres终端中执行：

sql
SELECT * FROM pg_extension;

将显示已安装的扩展列表，包括本镜像提供的额外扩展。

docker-compose配置示例

yaml
version: '3'
services:
  postgres:
    image: [镜像仓库地址]/postgres-extended:[版本标签]
    container_name: postgres-extended
    environment:
      POSTGRES_PASSWORD: mysecretpassword
      POSTGRES_USER: myuser
      POSTGRES_DB: mydb
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres-data:

注：实际使用时，请根据具体需求调整环境变量、端口映射和数据卷配置。