sudo mkdir -p /opt/data/ops/postgresql
cd /opt/data/ops/postgresql

# =============================================================================
# PostgreSQL 18.6 Docker Compose 部署文件
# 镜像版本：postgres:18.6（与《Ubuntu 22.04 安装 PostgreSQL 18 指南》版本一致）
# 使用方式：cd /opt/data/ops/postgresql && docker compose up -d
# 密码等敏感值通过环境变量注入，请先 export（见文档"六、常用环境变量表"章节）
# =============================================================================

services:
  postgres:
    # 镜像版本：18.6 官方镜像
    image: postgres:18.6

    # 容器名称，方便 docker ps / docker logs 定位
    container_name: postgres-18-6

    # 重启策略：容器异常退出时自动重启（除非手动 stop）
    restart: unless-stopped

    # ---- 常用环境变量配置（值由外部环境变量注入）----
    environment:
      - TZ=Asia/Shanghai                        # 容器时区（与宿主机一致）
      - POSTGRES_USER=${POSTGRES_USER:-app_user}      # 超级用户（默认 app_user）
      - POSTGRES_PASSWORD=${POSTGRES_PASSWORD:?请在环境变量中设置} # 超级用户密码
      - POSTGRES_DB=${POSTGRES_DB:-app_db}            # 自动创建的默认数据库

    # ---- 常用配置参数（-c 等价于写进 postgresql.conf）----
    # 说明：参数已统一放入 ./conf/postgresql.conf（见下方 volumes 挂载），
    # 修改配置只需编辑该文件后 docker compose restart postgres，无需改 yaml
    command:
      - "-c"
      - "config_file=/etc/postgresql/postgresql.conf"   # 使用自定义配置文件（完整替换默认 conf）

    # ---- 端口映射：宿主机15432 -> 容器5432 ----
    ports:
      - "15432:5432"

    # ---- 数据持久化（重要）----
    # 18+ 官方镜像使用 pg_ctlcluster 布局（数据在 /var/lib/postgresql/<版本>/<集群名>），
    # 必须挂载父目录 /var/lib/postgresql，否则容器启动报错
    volumes:
      - ./data:/var/lib/postgresql
      # ---- 配置文件持久化（重要）----
      # ./conf 为宿主机配置目录，挂载到 /etc/postgresql，
      # 通过 -c config_file 指定使用该配置文件，编辑后 docker compose restart postgres 生效
      - ./conf:/etc/postgresql

    # ---- 健康检查：容器内 pg_isready 判断数据库就绪 ----
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U $${POSTGRES_USER} -d $${POSTGRES_DB}"]
      interval: 10s      # 每 10 秒检查一次
      timeout: 5s        # 单次检查超时
      retries: 10        # 连续 10 次失败视为不健康
      start_period: 30s  # 启动后 30 秒才开始检查

    # 容器日志大小限制，防止磁盘被日志占满
    logging:
      driver: json-file
      options:
        max-size: "50m"
        max-file: "3"

# 注入密码（首次初始化生效，容器重建后需保持一致才能正常读取数据目录）
export POSTGRES_PASSWORD='your-password'

docker compose up -d

# 查看容器状态（healthy 表示健康检查通过）
docker ps --filter name=postgres-18-6

# 连接测试
docker exec -it postgres-18-6 psql -U app_user -d app_db

# 配置文件位于宿主机，可随时编辑
sudo vim /opt/data/ops/postgresql/conf/postgresql.conf

# PostgreSQL 自定义配置文件（挂载到 /etc/postgresql/postgresql.conf）
# 启动参数：-c config_file=/etc/postgresql/postgresql.conf（完整替换默认 postgresql.conf）
# 修改后重启容器生效：docker compose restart postgres

# 共享缓冲区（默认 128MB，建议设为物理内存的 25% 左右）
shared_buffers = 256MB

# 最大连接数（默认 100）
max_connections = 200

# 监听所有网卡（配合端口映射供外部连接）
listen_addresses = '*'

# 更多常用参数示例（按需取消注释）：
# work_mem = 16MB                    # 排序/哈希等操作的内存上限
# effective_cache_size = 4GB         # 操作系统缓存评估值（约物理内存的 50%~75%）
# maintenance_work_mem = 256MB       # 维护操作（VACUUM/索引重建）内存
# log_min_duration_statement = 1000  # 记录执行超过 1 秒的慢 SQL（毫秒）
# log_statement = 'none'             # 日志级别：none/ddl/mod/all

# 先注入环境变量
export POSTGRES_PASSWORD='your-password'

docker run -d \
  --name postgres-18-6 \
  --restart unless-stopped \
  -e TZ=Asia/Shanghai \
  -e POSTGRES_USER=app_user \
  -e POSTGRES_PASSWORD="$POSTGRES_PASSWORD" \
  -e POSTGRES_DB=app_db \
  -p 15432:5432 \
  -v /opt/data/ops/postgresql/data:/var/lib/postgresql \
  -v /opt/data/ops/postgresql/conf:/etc/postgresql \
  --health-cmd='pg_isready -U "$POSTGRES_USER" -d "$POSTGRES_DB"' \
  --health-interval=10s \
  --health-timeout=5s \
  --health-retries=10 \
  --health-start-period=30s \
  postgres:18.6 \
  -c config_file=/etc/postgresql/postgresql.conf

# 查看日志
docker logs -f postgres-18-6

# 重启容器（数据保留）
docker compose restart

# 停止并移除容器（保留数据）
docker compose down

# 彻底移除容器 + 数据目录（谨慎操作！）
docker compose down -v

# 进入 psql 交互
docker exec -it postgres-18-6 psql -U app_user -d app_db