docker-crontab

一个基于docker的简单包装工具，允许在其他容器中运行复杂的Cron任务。

支持的标签和Dockerfile链接

latest (Dockerfile)

为什么创建此项目？

是的，我知道mcuadros/ofelia（280MB），它是本项目的主要灵感来源。这是一个很棒的项目，请勿误解。只是它缺少一些我认为支持Docker发展方向所需的关键企业特性。

特性

支持易读的调度语法。
允许添加注释，方便提醒update_script.sh等脚本的实际功能。
使用image启动镜像。
使用container在容器中运行命令。
使用project在扩展容器的实例上运行命令。
支持通过trigger在定时任务完成后触发其他容器中的脚本。

Config.json

name：作业文件名的可读名称，会转换为slug格式。可选。
comment：包含在crontab条目中的注释。可选。
schedule：Cron调度语法，详见***。例如@hourly、@every 1h30m、* * * * *。必填。
command：在crontab容器或Docker容器/镜像中运行的命令。必填。
image：Docker镜像名称（例如library/alpine:3.5）。可选。
project：Docker Compose/Swarm项目名称。可选，仅在包含container时适用。
container：完整容器名称或容器别名（如果设置了project）。如果包含image则忽略此项。可选。
dockerargs：Docker run/exec命令行参数，用于完全控制。默认为空字符串。
trigger：docker-crontab子集对象数组。子集包含：image、project、container、command、dockerargs。
onstart：在crontab容器启动时运行命令，设为true。可选，默认为false。

查看config.sample.json获取示例。

json
[{
	"schedule":"@every 5m",
	"command": "/usr/sbin/logrotate /etc/logrotate.conf"
},{
	"comment":"重新生成证书并重新加载nginx",
	"schedule":"43 6,18 * * *",
	"command":"sh -c 'dehydrated --cron --out /etc/ssl --domain ${LE_DOMAIN} --challenge dns-01 --hook dehydrated-dns'",
	"dockerargs":"--env-file /opt/crontab/env/letsencrypt.env -v webapp_nginx_tls_cert:/etc/ssl -v webapp_nginx_acme_challenge:/var/www/.well-known/acme-challenge",
	"image":"willfarrell/letsencrypt",
	"trigger":[{
		"command":"sh -c '/etc/scripts/make_hpkp ${NGINX_DOMAIN} && /usr/sbin/nginx -t && /usr/sbin/nginx -s reload'",
		"project":"conduit",
		"container":"nginx"
	}],
	"onstart":true
}]

如何使用

命令行

bash
docker build -t crontab .
docker run -d \
    -v /var/run/docker.sock:/var/run/docker.sock:ro \
    -v ./env:/opt/env:ro \
    -v /path/to/config/dir:/opt/crontab:rw \
    -v /path/to/logs:/var/log/crontab:rw \
    crontab

与docker-compose一起使用

确定docker-compose容器使用的网络名称
- 使用docker network ls查看现有网络
- 如果docker-compose.yml在my_dir目录中，网络可能为my_dir_default
- 否则阅读docker-compose文档
在docker-crontab的config.json中添加dockerargs
- 使用--network NETWORK_NAME将新容器连接到docker-compose网络
- 使用--rm --name NAME指定容器名称
- 例如："dockerargs": "--network my_dir_default --rm --name my-best-cron-job"

Dockerfile

Dockerfile
FROM willfarrell/crontab

COPY config.json ${HOME_DIR}/

Logrotate Dockerfile

Dockerfile
FROM willfarrell/crontab

RUN apk add --no-cache logrotate
RUN echo "*/5 *	* * *  /usr/sbin/logrotate /etc/logrotate.conf" >> /etc/crontabs/logrotate
COPY logrotate.conf /etc/logrotate.conf

CMD ["crond", "-f"]