chiavegatto/postgres-pgagent

镜像概述和主要用途

该镜像基于官方PostgreSQL镜像构建，集成了pgagent工具。pgagent是PostgreSQL的作业调度器，可用于在PostgreSQL数据库中创建、管理和执行定时任务，适用于需要数据库级定时任务调度的场景。

核心功能和特性

• 基于PostgreSQL镜像：确保与PostgreSQL生态的兼容性
• 集成pgagent工具：提供PostgreSQL数据库定时任务管理能力
• 时区配置支持：通过环境变量设置运行时区
• 依赖联动机制：支持等待PostgreSQL服务就绪后再初始化

使用场景和适用范围

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

• 定期数据库备份
• 数据清理与归档
• 定时报表生成
• 周期性数据同步
• 自动执行SQL脚本

使用方法和配置说明### 前置条件

• 需运行PostgreSQL服务实例，并确保网络互通
• PostgreSQL数据库需允许外部连接（配置合适的pg_hba.conf）

环境变量说明

Docker Compose部署示例

yaml
version: '3.2'
services:

  postgres:
    image: postgres
    ports:
      - 5432:5432
    environment:
      - POSTGRES_DB=test  # 数据库名称
      - POSTGRES_PASSWORD=123456  # 数据库密码
    volumes:
      - db-data:/var/lib/postgresql/data  # 持久化数据库数据

  pgagent:
    image: chiavegatto/postgres-pgagent
    entrypoint: /bin/sh -c
                "/tmp/wait-for-it.sh postgres:5432 --timeout=30 &&  # 等待PostgreSQL服务就绪
                PGPASSWORD='123456' psql -U postgres -h postgres -p 5432 -d test -c 'CREATE EXTENSION IF NOT EXISTS pgagent;' &&  # 创建pgagent扩展
                PGPASSWORD='123456' pgagent -f hostaddr=postgres dbname=test user=postgres port=5432"  # 启动pgagent服务
    environment:
      - TIMEZONE=America/Manaus  # 设置时区

volumes:
  db-data:

Entrypoint配置说明

pgagent服务的entrypoint执行以下关键步骤：

1. 使用wait-for-it.sh等待PostgreSQL服务在5432端口可用，超时时间30秒
2. 通过psql命令连接PostgreSQL数据库，创建pgagent扩展（CREATE EXTENSION IF NOT EXISTS pgagent;）
3. 启动pgagent服务，连接到指定的PostgreSQL数据库（参数包括主机地址、数据库名、用户名和端口）

使用注意事项

• 需确保PostgreSQL数据库用户（示例中为postgres）具有创建扩展的权限
• PGPASSWORD环境变量需与PostgreSQL服务的密码保持一致
• 调整entrypoint中的数据库连接参数（如主机名、数据库名、端口）以匹配实际环境