streetteam/circleci-postgres-ram

PostgreSQL 高连接数镜像文档

镜像概述

本镜像基于CircleCI官方的postgres-ram镜像构建，保留了其轻量级、内存优化的特性，核心改进在于提升了PostgreSQL的max_connections（最大连接数）配置，以支持更高并发的数据库连接需求。

核心功能与特性

• 基于CircleCI postgres-ram：继承原镜像的内存优化特性，适合对性能敏感的场景
• 提高最大连接数：调整max_connections参数至更高值（具体数值取决于基础镜像版本，通常高于默认的100）
• 原生PostgreSQL功能：支持PostgreSQL的标准功能，包括数据持久化、用户管理、权限控制等
• 轻量级设计：保持与基础镜像一致的精简体积，适合快速部署

使用场景

• CI/CD流水线：作为自动化测试环境的数据库服务，支持多任务并发连接
• 开发环境：本地开发或团队协作时，满足多应用实例同时连接数据库的需求
• 压力测试：模拟高并发连接场景下的应用性能测试

使用方法

基本部署（Docker Run）

bash
docker run -d \
  --name postgres-high-connections \
  -p 5432:5432 \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_DB=mydb \
  [镜像名称]

Docker Compose配置

yaml
version: '3'
services:
  postgres:
    image: [镜像名称]
    container_name: postgres-high-connections
    ports:
      - "5432:5432"
    environment:
      POSTGRES_PASSWORD: mysecretpassword
      POSTGRES_USER: myuser
      POSTGRES_DB: mydb
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

配置说明

环境变量

• POSTGRES_PASSWORD：必填，设置数据库超级用户密码
• POSTGRES_USER：可选，指定数据库超级用户名（默认：postgres）
• POSTGRES_DB：可选，指定默认数据库名称（默认与用户名相同）

连接数验证

启动容器后，可通过以下命令验证最大连接数配置：

bash
docker exec -it postgres-high-connections psql -U myuser -d mydb -c "SHOW max_connections;"

自定义配置（可选）

如需进一步调整连接数或其他PostgreSQL参数，可通过挂载配置文件实现：

bash
docker run -d \
  --name postgres-high-connections \
  -p 5432:5432 \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -v /path/to/custom/postgresql.conf:/etc/postgresql/postgresql.conf \
  [镜像名称]

注意事项

• 本镜像主要面向开发、测试及CI/CD场景，生产环境使用需额外配置数据备份和高可用策略
• 提高连接数可能增加内存消耗，建议根据实际资源情况调整配置
• 基础镜像的postgres-ram特性可能默认使用内存文件系统，数据仅在容器运行期间保留，如需持久化需挂载数据卷