Swarm 集群 如何定时任务

定时任务是常见需求。普遍的做法是，选择一台或几台机器，通过 crontab 实现定时任务。但是对于大规模或大量的定时任务，这种做法的缺点非常多，比如：

• 可靠性低，一台机器宕机，该机器上的定时任务就无法执行了。
• 没有调度功能，机器之间的负载可能不均衡。
• 没有重试机制，任务可能运行失败。
• 无法运行大规模分布式任务。

容器服务在离线任务的基础上，增加了定时任务的功能，通过简单的描述，解决了上述问题。关于离线任务的详细信息，参见 运行离线任务。

[backcolor=transparent]注意：只有10月25号之后升级了 Agent 版本或新创建的集群才能使用该功能。

基于 Docker Compose 的定时任务描述

同离线任务一样，定时任务也是基于 Docker Compose 的，您只需要在应用模板里添加 aliyun.schedule 标签即可实现定时功能。如下面的例子所示。

[backcolor=transparent]注意：定时任务在创建和更新时不会拉取最新镜像，因为使用最新镜像会导致同一个任务在不同的时间使用不同的镜像，会造成排查问题复杂化。建议您通过更改镜像 tag 来变更镜像。

1. [backcolor=transparent]version[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"2"
2. [backcolor=transparent]labels[backcolor=transparent]:
3. [backcolor=transparent]  aliyun[backcolor=transparent].[backcolor=transparent]project_type[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"batch"
4. [backcolor=transparent]  aliyun[backcolor=transparent].[backcolor=transparent]schedule[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"0-59/30 * * * * *"
5. [backcolor=transparent]services[backcolor=transparent]:
6. [backcolor=transparent]  s1[backcolor=transparent]:
7. [backcolor=transparent]    image[backcolor=transparent]:[backcolor=transparent] registry[backcolor=transparent].[backcolor=transparent]aliyuncs[backcolor=transparent].[backcolor=transparent]com[backcolor=transparent]/[backcolor=transparent]jimmycmh[backcolor=transparent]/[backcolor=transparent]busybox[backcolor=transparent]:[backcolor=transparent]latest
8. [backcolor=transparent]    labels[backcolor=transparent]:
9. [backcolor=transparent]      aliyun[backcolor=transparent].[backcolor=transparent]scale[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"5"
10. [backcolor=transparent]      aliyun[backcolor=transparent].[backcolor=transparent]retry_count[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"3"
11. [backcolor=transparent]      aliyun[backcolor=transparent].[backcolor=transparent]remove_containers[backcolor=transparent]:[backcolor=transparent] [backcolor=transparent]"remove-all"
12. [backcolor=transparent]    command[backcolor=transparent]:[backcolor=transparent] date

[backcolor=transparent]说明：

• 
  aliyun.schedule: "0-59/30 * * * * *"表示每 30 秒执行一次该任务；schedule 的格式和 crontab 完全相同（但要注意 schedule 的格式为 秒 分 时 天 月 星期，比 Linux 上的 crontab 多了秒这一项），使用的时间为北京时间。
• 
  因为定时功能只适用于离线任务，所以只要您添加了 aliyun.schedule 标签，系统会自动添加aliyun.project_type: "batch" 标签，因此上述例子中的 aliyun.project_type: "batch" 可以省略。
• 
  另外，离线任务中所有的功能，在定时任务中依然可用，比如scale、retry_count、remove_containers 等。有关标签的具体含义，参见 运行离线任务。

执行过程
定时任务被创建后，应用处于“等待”状态。当任务指定的时间到达时，任务会被启动运行，其后的状态变化和离线应用相同；下一个执行时间到达时，应用状态会重复这一过程。
同一个定时任务同一时刻只会有一个实例在执行，如果任务的执行时间大于其执行周期（比如上述任务的执行时间大于 30 秒），则下一次执行会进入执行队列；如果执行队列长度大于 3，则会丢弃该次执行。
您可以在应用详情页面单击 [backcolor=transparent]运行历史 查看运行历史及结果，如下图所示。运行历史列表只保留最后 10 次的运行历史。
高可用性
定时任务控制器采用主-从备模式。主控制器故障时，控制功能将切换至备用控制器。
如果任务的执行时刻正好在主从切换期间，则会延迟至切换完成后执行。如果主从切换期间同一个任务有多次执行，切换完成后只会执行一次；因此，为了保证任务不丢失，请不要设计重复周期小于一分钟的任务。