vipconsult/cron

镜像概述

该镜像用于在Docker环境中运行定时任务（cron），通过挂载宿主机的docker.sock文件使用Docker客户端，无需直接挂载docker可执行文件。镜像使用supervisor管理rsyslog和cron服务，确保cron日志能正常输出到/var/log/syslog，并支持通过邮件发送任务执行结果。

核心功能

• 运行cron定时任务，支持多任务配置
• 通过docker.sock调用Docker客户端，在容器内执行任务
• 自动将环境变量传递到crontab，避免命令执行时环境变量缺失问题
• 支持邮件通知任务输出，可配置SMTP服务器和接收***
• 使用supervisor管理rsyslog和cron服务，保证服务正常运行

使用场景

• 容器化环境下的定时备份任务
• 周期性数据同步或处理任务
• 定期执行脚本或命令的场景
• 需要邮件通知任务结果的定时任务管理

配置说明

环境变量

• DOCKER_API_VERSION：指定Docker API版本，解决客户端与服务器版本不匹配问题（如1.23）
• SMTP_SERVER：邮件服务器地址（如smtpContainer）
• MAILTO：接收任务结果邮件的地址（如）
• DOMAINNAME：邮件的发件和收件域名（如domain.com）
• CRONTASK_：定义定时任务，格式为 cron表达式 用户 命令（如CRONTASK_1=" * * * * root docker run debian echo '任务执行'"）

部署示例

手动运行

1. 创建用户定义网络（解决容器间通信问题）：

bash
docker network create cronApp

2. 启动SMTP容器（用于邮件通知）：

bash
docker run -d \
    --name=smtpContainer \
    --net cronApp \
    -e DOMAINNAME=domain.com \
    -e SMTP_INTERVAL=1m \
    -e SMTP_PROCESSING=queue_only_load_latch \
    -e SMTP_remote_max_parallel=2 \
    -e SMTP_queue_run_max=3 \
    -e SMTP_timeout_frozen_after=3h \
    vipconsult/smtp

3. 启动cron容器：

bash
docker run -d \
    --name=cronContainer \
    --net cronApp \
    -v /var/run/docker.sock:/var/run/docker.sock:ro \
    -e DOMAINNAME=domain.com \
    -e DOCKER_API_VERSION=1.23 \
    -e SMTP_SERVER=smtpContainer \
    -e MAILTO=email@domain.com \
    -e CRONTASK_1="* * * * * root docker run debian echo 'Cron 1 run from docker container'" \
    -e CRONTASK_2="* * * * * root docker run debian echo 'Cron 2 run from docker container'" \
    vipconsult/cron

Docker Compose配置

yaml
version: '2'
services:
    cron:
        image: vipconsult/cron
        container_name: cronContainer
        volumes:
            - /var/run/docker.sock:/var/run/docker.sock:ro
        environment:
            - DOCKER_API_VERSION=1.23
            - SMTP_SERVER=smtpContainer
            - DOMAINNAME=domain.com
            - MAILTO=email@domain.com
            - CRONTASK_1=* * * * * root docker run debian echo 'Cron 1 run from docker container'
            - CRONTASK_2=* * * * * root docker run debian echo 'Cron 2 run from docker container'

    smtp:
        image: vipconsult/smtp
        container_name: smtpContainer
        environment:
            - DOMAINNAME=domain.com
            - SMTP_INTERVAL=1m
            - SMTP_PROCESSING=queue_only_load_latch
            - SMTP_remote_max_parallel=2
            - SMTP_queue_run_max=3
            - SMTP_timeout_frozen_after=3h

日志查看

• 查看cron容器日志：docker logs cronContainer
• 查看SMTP容器日志：docker logs smtpContainer