gchandra905/postgres-pgcron

PostgreSQL Alpine 镜像（含 pg_cron 扩展）

镜像概述

基于官方PostgreSQL Alpine Docker镜像构建，在原生功能基础上集成了pg_cron扩展，提供轻量级PostgreSQL数据库服务的同时，支持数据库级定时任务调度能力。

核心功能与特性

• 基础PostgreSQL功能：完整继承Alpine版本PostgreSQL的全部核心功能，包括ACID事务、SQL标准支持、JSON数据类型等
• pg_cron扩展集成：内置PostgreSQL定时任务扩展，支持通过SQL语句创建、管理和删除定时任务
• 轻量级特性：延续Alpine Linux的轻量级优势，镜像体积小、资源占用低、启动速度快
• 兼容性：与官方PostgreSQL Alpine镜像接口完全兼容，可无缝替换使用

使用场景

适用于需要在PostgreSQL数据库内部执行定时任务的场景，例如：

• 定期数据清理与归档操作
• 周期性生成业务统计报表
• 定时数据库备份与恢复任务
• 数据同步与ETL流程自动化
• 数据库维护操作（如VACUUM、索引重建）

使用方法与配置说明

拉取镜像

bash
docker pull [镜像名称]  # 请替换为实际镜像仓库地址

基本运行示例

bash
docker run -d \
  --name postgres-pg-cron \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -e POSTGRES_USER=myuser \
  -e POSTGRES_DB=mydb \
  -p 5432:5432 \
  -v postgres-data:/var/lib/postgresql/data \
  [镜像名称]

pg_cron配置说明

该镜像默认已配置pg_cron所需参数：

• shared_preload_libraries = 'pg_cron'：预加载pg_cron扩展
• cron.database_name = 'postgres'：默认任务存储数据库

如需自定义配置，可通过挂载postgresql.conf文件修改：

bash
docker run -d \
  --name postgres-pg-cron \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -p 5432:5432 \
  -v /path/to/custom/postgresql.conf:/var/lib/postgresql/data/postgresql.conf \
  -v postgres-data:/var/lib/postgresql/data \
  [镜像名称]

定时任务操作示例

连接数据库后，可通过以下SQL命令管理定时任务：

sql
-- 创建定时任务：每分钟执行一次VACUUM ANALYZE
SELECT cron.schedule(
  'vacuum-analyze',  -- 任务名称
  '* * * * *',       -- 调度时间（crontab格式）
  'VACUUM ANALYZE;'  -- 执行的SQL语句
);

-- 创建定时任务：每天凌晨2点清理30天前的日志数据
SELECT cron.schedule(
  'clean-old-logs',
  '0 2 * * *',
  $DELETE FROM logs WHERE created_at < NOW() - INTERVAL '30 days'$
);

-- 查看所有定时任务
SELECT * FROM cron.job;

-- 停止定时任务（通过任务ID）
SELECT cron.unschedule(1);

-- 停止定时任务（通过任务名称）
SELECT cron.unschedule('clean-old-logs');

Docker Compose配置示例

yaml
version: '3.8'
services:
  postgres:
    image: [镜像名称]
    container_name: postgres-pg-cron
    environment:
      POSTGRES_PASSWORD: mysecretpassword
      POSTGRES_USER: appuser
      POSTGRES_DB: appdb
    ports:
      - "5432:5432"
    volumes:
      - postgres-data:/var/lib/postgresql/data
      # 可选：挂载自定义配置文件
      # - ./postgresql.conf:/var/lib/postgresql/data/postgresql.conf
    restart: unless-stopped

volumes:
  postgres-data:

注意事项

• pg_cron任务默认存储在postgres数据库中，如需在其他数据库使用，需先在目标数据库执行CREATE EXTENSION pg_cron;
• 定时任务执行结果可通过PostgreSQL日志查看
• 建议使用命名卷（named volume）持久化数据，避免容器删除导致数据丢失
• crontab时间格式遵循标准Unix cron语法（分 时 日 月 周）