cronner 分布式定时任务框架

cronner 定时任务框架将作业的配置和应用程序剥离，实现了集中作业配置和管理。支持作业分片和失效转移。 源代码参考了开源项目elastic-job。

githup地址：https://github.com/fang-yan-peng/cronner

一、架构图

Cronner 内部分为调度节点和执行节点。调度节点负责作业配置、作业分片和任务调度，多台调度节点之间是互为备份关系，如果一个节点down机，其它的调度节点会接管任务调度。执行节点负责任务的运行、失效转移。

二 例子

Cronner 支持spring、springboot和main方法启动的进程。Cronner 配置十分简单，通过几个注解就可以实现作业的调度。以下以spring boot为例，其它的例子github的代码里都提供了。目前jar包还没有上传到maven私服，正在申请的过程中。运行例子需要下载源码编译jar包。

1. 添加依赖.

    <dependency>     <groupId>org.jfaster.cronner</groupId>     <artifactId>spring-boot-starter-cronner</artifactId>     <version>1.0.1</version> </dependency> <dependency>     <groupId>org.jfaster.cronner</groupId>     <artifactId>spring-boot-starter-zookeeper</artifactId>     <version>1.0.1</version> </dependency>

2. 创建一个作业。

   src/main/java/cronner/jfaster/org/example/job/listener/JobListenerExample.java

   src/main/java/cronner/jfaster/org/example/job/SimpeCronnerJobSpringboot.java

       package cronner.jfaster.org.example.job.listener;        import cronner.jfaster.org.executor.ShardingContexts;    import cronner.jfaster.org.job.api.listener.CronnerJobListener;        /**     * @author fangyanpeng     */        public class JobListenerExample implements CronnerJobListener{            @Override        public void beforeJobExecuted(ShardingContexts shardingContexts) {            System.out.println(String.format("----SpringBoot Job: %s begin----",shardingContexts.getJobName()));        }            @Override        public void afterJobExecuted(ShardingContexts shardingContexts) {            System.out.println(String.format("----SpringBoot Job: %s end----",shardingContexts.getJobName()));        }    }

       package cronner.jfaster.org.example.job;        import cronner.jfaster.org.job.annotation.Job;    import cronner.jfaster.org.example.job.listener.JobListenerExample;    import cronner.jfaster.org.job.api.ShardingContext;    import cronner.jfaster.org.job.api.simple.SimpleJob;        import java.util.concurrent.TimeUnit;        /**     * @author fangyanpeng     */    @Job(name = "cronner-simple-job",listener = JobListenerExample.class)    public class SimpeCronnerJobSpringboot implements SimpleJob {        @Override        public void execute(ShardingContext shardingContext) {            try {                TimeUnit.SECONDS.sleep(2);            } catch (InterruptedException e) {                e.printStackTrace();            }            System.out.println(String.format("jobName=%s,jobParameter=%s,shardingItem=%s,shardingParameter=%s",shardingContext.getJobName(),shardingContext.getJobParameter(),shardingContext.getShardingItem(),shardingContext.getShardingParameter()));        }    }

3. 配置yml文件，并启动作业。

       ########### Zookeeper Configuration Start ###########    zookeeper:          serverLists: 127.0.0.1:2181,127.0.0.1:2182,127.0.0.1:2183          namespace: cronner          baseSleepTimeMilliseconds: 1000          maxSleepTimeMilliseconds: 3000          maxRetries: 3        ############ Zookeeper Configuration End ###########        ########### cronner packege Configuration Start ###########        cronner:          package: cronner.jfaster.org.example.job        ############ cronner packege Configuration End ###########    

   src/main/java/cronner/jfaster/org/example/CronnerSpringBootMain.java

       package cronner.jfaster.org.example;        import org.springframework.boot.SpringApplication;    import org.springframework.boot.autoconfigure.SpringBootApplication;    import org.springframework.context.ConfigurableApplicationContext;        /**     * @author fangyanpeng     */    @SpringBootApplication    public class CronnerSpringBootMain {        public static void main(String[] args) {            ConfigurableApplicationContext context = SpringApplication.run(CronnerSpringBootMain.class,args);        }    }

   执行main方法，就会启动作业，就是一个执行节点。每个执行节点都会启动一个端口接收调度节点的命令，默认端口9233。如果同一台机器启动多个执行节点，通过java -Dcronner.executor.port=8888指定端口，避免端口冲突。

4. 启动调度节点，添加作业调度项

   • tar -zxvf cronner-manager-1.0.1.tar.gz
   • cd cronner-manager-1.0.1
   • vim conf/cronner.conf 修改登陆后台的用户名、密码、端口号、数据库地址、zk地址、jvm参数等。
   • sh bin/cronner.sh start 启动节点
   • 默认启动2145 端口
   • 访问 http://127.0.0.1:2145端口

   就会出现作业的配置页面，点击  作业配置》配置管理》添加   进行添加作业，都是页面可视化的，具体的配置和添加步骤github都有例子。注意添加的作业名称一定要与要调度的作业名一致，例如上面的 cronner-simple-job