opamp/postgres

opamp/postgres 镜像文档

镜像概述和主要用途

opamp/postgres是一个个人使用的PostgreSQL Docker镜像，用于在Docker环境中便捷地部署和运行PostgreSQL数据库。该镜像设计用于简化PostgreSQL的配置和管理，支持数据持久化和日志管理，适合个人开发或测试场景使用。

核心功能和特性

• 自定义配置：通过pgconfig目录下的配置文件进行数据库配置，构建时自动应用
• 数据持久化：支持通过volume挂载数据目录，确保数据库数据不会因容器重启丢失
• 日志管理：日志输出到/var/log/pg_log目录，可通过volume挂载实现日志持久化
• 环境变量配置：支持通过环境变量设置数据库密码和数据目录路径

使用场景和适用范围

适用于个人开发环境、测试环境中需要快速部署PostgreSQL数据库的场景，尤其适合需要自定义配置和数据持久化的用户。

使用方法和配置说明

配置文件管理

镜像的配置文件位于pgconfig目录下，在容器构建时会自动应用这些配置。如需修改配置，需在构建镜像前修改pgconfig目录下的相应文件，然后重新构建。

日志目录说明

• 日志路径：容器内日志输出目录为/var/log/pg_log
• 持久化方法：通过volume挂载该目录到宿主机，实现日志持久化
• 权限注意事项：pg_log目录不会自动修改权限，需确保宿主机挂载目录有正确的访问权限

Docker Compose配置示例

yaml
postgres:
  build: postgres/
  ports:
    - "5432:5432"
  volumes:
    - "/var/log/docker-postgres:/var/log/pg_log"  # 日志持久化
    - "/var/lib/docker-postgres:/var/lib/docker-postgres"  # 数据持久化
  environment:
    - POSTGRES_PASSWORD=postgres  # PostgreSQL管理员密码
    - PGDATA=/var/lib/docker-postgres  # 数据目录路径

环境变量说明

POSTGRES_PASSWORD

• 作用：设置PostgreSQL默认管理员用户（postgres）的密码
• 默认值：postgres
• 注意事项：仅在首次启动容器时生效，后续启动不会自动更新密码，如需修改需手动操作数据库

PGDATA

• 作用：指定容器内PostgreSQL数据目录的路径
• 默认值：/var/lib/postgresql/data
• 使用方法：通过volume挂载该目录到宿主机，可实现数据库数据的持久化存储