christopherdavenport/postgres-db-with-role

postgres-db-with-role

镜像概述

postgres-db-with-role 是一个基于 PostgreSQL 的 Docker 镜像，扩展了原生 Postgres 镜像的功能，通过新增的环境变量 POSTGRES_ROLE 实现数据库角色的自动创建与权限配置。该镜像旨在简化需要特定角色和权限设置的 PostgreSQL 部署流程。

核心功能与特性

• 角色自动创建：通过 POSTGRES_ROLE 环境变量指定需创建的数据库角色
• 权限 delegation：自动将创建的角色赋予 POSTGRES_USER
• 数据库权限授予：为创建的角色授予对 POSTGRES_DB 数据库的所有权限

使用场景与适用范围

• 开发环境中需要快速配置具有特定权限的数据库角色
• 应用部署时需预配置数据库访问角色的场景
• 需要标准化数据库角色与权限设置的容器化部署

使用方法与配置说明

环境变量配置

Docker 运行示例

bash
docker run -d \
  --name postgres-with-role \
  -e POSTGRES_USER=admin \
  -e POSTGRES_PASSWORD=securepassword \
  -e POSTGRES_DB=myappdb \
  -e POSTGRES_ROLE=appuser \
  -p 5432:5432 \
  christopherdavenport/postgres-db-with-role

Docker Compose 配置示例

yaml
version: '3'
services:
  postgres:
    image: christopherdavenport/postgres-db-with-role
    container_name: postgres-with-role
    environment:
      - POSTGRES_USER=admin
      - POSTGRES_PASSWORD=securepassword
      - POSTGRES_DB=myappdb
      - POSTGRES_ROLE=appuser
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

工作流程说明

1. 容器启动时，首先执行原生 Postgres 镜像的初始化流程
2. 额外检查 POSTGRES_ROLE 环境变量是否设置
3. 创建指定名称的数据库角色
4. 将该角色赋予 POSTGRES_USER
5. 授予该角色对 POSTGRES_DB 数据库的所有权限（ALL PRIVILEGES ON DATABASE）

镜像信息

• Docker Hub 地址：https://hub.docker.com/r/christopherdavenport/postgres-db-with-role/
• 构建状态：![Build Status]([***]
• 自动构建：
• 拉取量：