groundworkdevelopment/cron

Legacy Cron Jobs 镜像文档

镜像概述和主要用途

本Docker镜像专为合作伙伴应用设计，用于运行和管理遗留定时任务（Cron Jobs），解决传统定时任务在容器化环境中的部署、调度与维护问题。通过标准化容器封装，提供轻量级、可移植的遗留定时任务运行环境，确保合作伙伴应用的传统定时任务（如数据同步、报表生成、定时通知等）在现代容器架构中稳定执行。

核心功能和特性

• 遗留系统兼容性：支持传统Cron语法及任务脚本，兼容合作伙伴应用中的遗留任务逻辑与依赖
• 标准Cron调度：遵循POSIX标准Cron语法，支持分钟、小时、日、月、周级别的任务调度
• 任务日志管理：内置日志记录机制，自动捕获任务输出并持久化，支持日志级别配置
• 轻量级运行环境：基于Alpine Linux构建，镜像体积小，资源占用低，适合边缘节点与资源受限环境
• 灵活配置方式：支持通过环境变量、配置文件或挂载目录自定义任务调度规则与执行参数

使用场景和适用范围

典型使用场景

• 合作伙伴应用需执行传统定时任务时（如每日数据备份、周期性报表生成）
• 遗留系统迁移至容器化环境后，需保留原有Cron任务调度逻辑时
• 多合作伙伴应用的定时任务需统一容器化管理与资源隔离时
• 需要为传统脚本任务提供标准化容器运行环境时

适用范围

• 依赖标准Linux命令或脚本的定时任务（Bash/Shell/Python等）
• 不需要复杂依赖管理的轻量级定时任务
• 合作伙伴应用中无法立即重构的遗留定时任务模块

使用方法与配置说明

基础使用步骤

1. 准备任务配置
   创建Cron任务配置文件（如cron.d/tasks），按标准Cron格式定义任务：

   bash
   # 示例：每天凌晨2点执行数据同步脚本
   0 2 * * * root /app/scripts/data_sync.sh >> /var/log/data_sync.log 2>&1
   

2. 启动容器
   通过docker run命令挂载配置文件并启动镜像：

   bash
   docker run -d \
     --name partner-cron-job \
     -v /host/path/cron.d:/etc/cron.d \  # 挂载Cron任务配置目录
     -v /host/path/logs:/var/log \      # 挂载日志目录（可选）
     -e TZ=Asia/Shanghai \              # 设置时区（可选）
     legacy-cron-jobs:latest
   

Docker Compose配置示例

yaml
version: '3'
services:
  partner-cron:
    image: legacy-cron-jobs:latest
    container_name: partner-cron-service
    volumes:
      - ./cron.d:/etc/cron.d:ro  # 只读挂载任务配置目录
      - ./logs:/var/log/cron     # 持久化任务日志
      - ./scripts:/app/scripts   # 挂载任务执行脚本（如有）
    environment:
      - TZ=Asia/Shanghai
      - LOG_LEVEL=info           # 日志级别：debug/info/warn/error
    restart: unless-stopped      # 异常退出后自动重启

配置参数说明

环境变量配置

目录挂载说明

任务日志查看

容器内日志默认存储于/var/log/cron.log（全局日志）及各任务自定义日志文件（如示例中的/var/log/data_sync.log）。可通过以下命令查看：

bash
# 查看全局Cron服务日志
docker exec -it partner-cron-job tail -f /var/log/cron.log

# 查看特定任务日志
docker exec -it partner-cron-job tail -f /var/log/data_sync.log