arcaneio/crontab

Docker Crontab

镜像概述和主要用途

本Docker镜像基于https://github.com/tinslice/docker-crontab%E9%A1%B9%E7%9B%AE%E6%9E%84%E5%BB%BA%EF%BC%88%E5%8C%85%E5%90%AB%E9%83%A8%E5%88%86%E9%A2%9D%E5%A4%96%E8%BD%AF%E4%BB%B6%E5%8C%85%EF%BC%89%EF%BC%8C%E4%B8%BB%E8%A6%81%E7%94%A8%E4%BA%8E%E9%80%9A%E8%BF%87%E5%AE%9A%E6%97%B6%E4%BB%BB%E5%8A%A1%EF%BC%88cron jobs）执行文件同步等周期性操作。镜像基于Alpine系统，体积轻量且包含基本Linux工具，适合需要定时执行命令的场景。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 环境变量配置：通过环境变量轻松定义定时任务，无需手动编辑crontab文件
• 灵活任务定义：支持任意cron表达式和命令组合
• 丰富工具集：包含lftp、rsync等工具，便于文件同步等操作
• 兼容性强：支持Docker Compose，易于集成到现有容器化架构

使用场景和适用范围

• 定期文件同步（本地目录、FTP、远程服务器等）
• 周期性数据备份
• 定时执行脚本或命令
• 自动化数据采集和处理
• 与其他服务配合实现定时数据流转

使用方法和配置说明

基本配置方法

通过定义以CRON_为前缀的环境变量来创建定时任务，变量名称需唯一，值的格式为：<cron表达式> <命令>。

示例

简单docker-compose示例

yaml
version: '3'

services:
  cron:
    image: arcaneio/crontab
    container_name: crontab
    environment:
      CRON_SAMPLE: '* * * * * echo 1分钟定时任务'
      CRON_ANOTHER_SAMPLE: '*/5 * * * * echo 5分钟定时任务'

FTP数据同步示例

从FTP位置同步数据，并通过共享卷与HTTP服务器共享。

yaml
version: '3'

volumes:
  local-data:

services:
  consumer:
    image: httpd
    container_name: ftp-data-consumer
    ports:
      - 8001:80
    volumes:
      - local-data:/usr/local/apache2/htdocs/data
  cron:
    image: arcaneio/crontab
    container_name: test-data-sync
    environment:
      CRON_RSYNC: '*/5 * * * * lftp -c "set ftp:list-options -a; open ftp://tgftp.nws.noaa.gov/data/tampa/; lcd /opt/synchronized-data; mirror --only-missing --only-newer --verbose --delete --allow-chown --allow-suid --no-umask --parallel=5"'
    volumes:
      - local-data:/opt/synchronized-data

通过FTP卷同步数据示例

将FTP地址挂载为卷，从FTP位置同步数据并与HTTP服务器共享。

yaml
version: '3'

volumes:
  local-data:
  ftp-location:
    driver: valuya/curlftpfs:next  # 确保已安装驱动插件：docker plugin install valuya/curlftpfs:next DEBUG=1
    driver_opts:
      address: ftp://tgftp.nws.noaa.gov/data/tampa/

services:
  consumer: 
    image: httpd
    container_name: ftp-data-consumer
    ports:
      - 8001:80
    volumes:
      - local-data:/usr/local/apache2/htdocs/data
  cron:
    image: arcaneio/crontab
    container_name: test-data-sync
    environment:
      CRON_RSYNC: "*/5 * * * * rsync -rzvt --inplace --update --progress --stats /opt/ftp-data/ /opt/synchronized-data"
    volumes:
      - ftp-location:/opt/ftp-data
      - local-data:/opt/synchronized-data

访问以下地址查看同步数据：http://localhost:8001/data/（若使用Docker Toolbox，则访问<[***]>）