task介绍和使用

https://gitee.com/yuejing/task 下的文档：[doc/task介绍和使用.docx]

task是什么？
task是一个任务调度统一管理平台。
目前主要是通过http（https）来进行任务的调度，http支持签名算法。

一张图能更加懂它是做什么的


从上图可以清楚的知道，它是一个管理所有系统的定时任务平台

task的特点

支持集群部署
任务的分配能实现负载均衡
任务调度失败后，会发送email提醒，前提是设置了任务发邮件提醒
数据库为mysql

task的架构

服务端：springBoot、springMVC、mybatis、Quartz
前端：jquery、boostarp3

task的部署

1. 去gitee下载最新代码，然后执行maven install，打开项目的target目录可以看到部署包task-1.0.0-bin.zip，然后解压该包，windows环境下双击bin/window/start.bat即可。如果环境为linux，执行bin/start.sh即可。

源码下载地址：

https://gitee.com/yuejing/task

2. 创建mysql数据库
默认系统会自动创建数据库(前提条件数据库的表结构为空时会自动创建)
初始化测试数据：文件在【doc】目录下的task-init.sql文件里面

3. 修改部署时的jdbc连接信息
文件所在目录为项目下的resources里面的application.properties 文件，修改对应的信息即可
当打包成war时，修改配置文件的位置为/WEB-INF/classes/application.properties 文件，修改对应的信息即可

jdbc1.driverClassName=com.mysql.jdbc.Driver
jdbc1.url=jdbc:mysql://127.0.0.1:3306/task?useUnicode=true&characterEncoding=UTF-8
jdbc1.username=root
jdbc1.password=root

4. 设置服务定时任务可使用的线程数
文件所在目录为项目下的resources里面的application.properties 文件，修改对应的信息即可
当打包成war时，修改配置文件的位置为/WEB-INF/classes/application.properties 文件，修改对应的信息即可

#任务的执行线程数,不设置默认为100
project.task.thread.num=100

5. 在eclipse或idea中run as com.ms.server.TaskApplication.java (也可以打包成可执行程序，maven install，然后在target下有个task-1.0.0-bin.zip文件，解压后，window下执行bin/window/start.bat文件。linux下执行bin/start.sh文件)

6. 打开浏览器访问对应的地址
http://127.0.0.1:8380/

task的登录

打开首页(http://127.0.0.1:8380/)
输入用户：admin 密码：123456 然后点击【登录】

用户管理

这里可以修改用户的资料密码等信息，也可以添加多个帐号
注意，这里建议别删除admin帐号，不然又得去数据库中添加记录了


系统配置

这里一般采用默认的形式即可

添加任务

比如给支付系统添加任务
系统项目配置
进入项目管理 -> 点击添加项目

添加项目

加密方式解读
1. 不加密
就是该项目下调用的接口都不加密

2. md5(token)
选择后，出现如下内容
{token:"sdfsdfsfsdf",sign:"encryptionParameters"}
token代表和业务系统协商好的密钥，用户md5加密的密钥参数
sign代表token的值，采用md5加密后的值
任务发送http请求时，会增量带参数有sign

3. md5(渠道+token) 
选择后，出现如下内容
{channel:"50",token:"sdfsdfsfsdf",sign:"encryptionParameters"} 
token代表和业务系统协商好的密钥，用户md5加密的密钥参数
channel代表业务系统要求传入的参数（注意：channel的名字是可以改变的）
sign代表channel的值+token的值，采用md5加密后的值
任务发送http请求时，会增量带参数有channel、sign

4. md5(时间戳+token) 
选择后，出现如下内容
{time:"theCurrentTimestamp",token:"sdfsdfsfsdf",sign:"encryptionParameters"} 
token代表和业务系统协商好的密钥，用户md5加密的密钥参数
time代表业务系统要求传入的参数，具体值为当前请求的时间戳（注意：time的名字是可以改变的，单位是精确到ms）
sign代表time的值+token的值，采用md5加密后的值
任务发送http请求时，会增量带参数有time、sign

5. md5(渠道+时间戳+token) 
选择后，出现如下内容
{channel:"50",time:"theCurrentTimestamp",token:"sdfsdfsfsdf",sign:"encryptionParameters"} 
token代表和业务系统协商好的密钥，用户md5加密的密钥参数
channel代表业务系统要求传入的参数（注意：channel的名字是可以改变的）
time代表业务系统要求传入的参数，具体值为当前请求的时间戳（注意：time的名字是可以改变的，单位是精确到ms）
sign代表channel的值+time的值+token的值，采用md5加密后的值
任务发送http请求时，会增量带参数有channel、time、sign

邮件通知
如果选中了否，代表该项目下的所有任务调度失败的都不发送邮件通知

接收邮箱
为接收调度任务失败的邮件通知的邮箱，支持多个邮箱用,分隔（注意是英文的,）
### 项目任务配置

点击【项目管理】记录中的任务管理

在该项目下新增一个任务
 

新增任务

1. 名称
任务的名称，用于说明任务做什么

2. 描叙
用来描叙任务

3. 调用链接
执行任务时，http请求的地址（注意：如果项目设置了加密，则会带上相应的加密参数）

4. 任务规则
quartz的调度规则，具体可以参考quartz的规则语法
这里的【0/15 * * * * ?】代表每隔15秒执行一次

5. 任务执行状态
代表当前任务的状态，正常表示执行中，停止代表该任务不执行
当出现待添加的状态，代表任务还在等待添加的状态

6. 失败邮件通知
这里通知的是项目设定的邮箱

调度日志

点击【调度日志】进入后，可以查看到对应的调度记录

日志列表

点击查看可以，看到具体的信息
 

项目图表

点击【任务管理-项目图表】，可以看到支付系统的详细任务数，其它的系统为自己加的测试系统
 

服务管理

点击【任务管理-服务管理】进入，可以查到看当前集群的服务，如果服务停止，则会显示已销毁
 

服务图表

点击【任务管理-服务图表】进入，可以查看到各个服务当前所执行的任务数