webcron

一个定时任务管理器，基于Go语言和beego框架开发。用于统一管理项目中的定时任务，提供可视化配置界面、执行日志记录、邮件通知等功能，无需依赖*unix下的crontab服务。

项目背景

开发此项目是为了解决本人所在公司的PHP项目中定时任务繁多，使用crontab不好管理的问题。我所在项目的定时任务也是PHP编写的，属于整个项目的一部分，我希望能有一个系统可以统一配置这些定时任务，并且可以查看每次任务的执行情况，任务执行完成或失败能够自动邮件提醒开发人员，因此做了这个项目。

功能特点

• 统一管理多种定时任务。
• 秒级定时器，使用crontab的时间表达式。
• 可随时暂停任务。
• 记录每次任务的执行结果。
• 执行结果邮件通知。

界面截图

 

安装说明

系统需要安装Go和MySQL。

1、安装go语言环境（go1.9.2.linux-amd64.tar.gz）：解压缩到路径/usr/local/go

go下载地址：https://dl.gocn.io/

2、 添加环境变量（vi /etc/profile）：

export GOROOT=/usr/local/go
export GOBIN=$GOROOT/bin
export PATH=$PATH:$GOBIN
export GOPATH=/usr/local/webcron
export AUTO_GOPATH=1

3、获取源码（如git未安装则会报错）

$ go get github.com/lisijie/webcron

4 打开配置文件 conf/app.conf，修改相关配置（修改任务数和数据库配置 ）：

appname = webcron

httpport = 8000

runmode = dev 

# 允许同时运行的任务数

jobs.pool = 50 

# 站点名称

site.name = 定时任务管理器

# 数据库配置

db.host = ip端口（192.168.11.11）

db.user = 用户名

db.password = 密码

db.port = 3306

db.name = dataserver

db.prefix = t_

db.timezone = Asia/Shanghai

# 邮件服务器配置

mail.queue_size = 100

mail.from = no-reply@example.com

mail.host = smtp.example.com

mail.port = 25

mail.user = username

mail.password = your password

5 创建数据库webcron ，再导入install.sql

6 创建数据库表

  $ mysql -u username -p -D webcron < install.sql

7 编译构建webcron

  $  **cd** /usr/local/webcron/src/github.com/lisijie/webcron

  $  go build

8 运行webcron

$**cd** /usr/local/webcron/src/github.com/lisijie/webcron

$ ./webcron 或 $ nohup ./webcron 2>&1 > error.log &

设为后台运行

9 访问

http://localhost:8000

帐号：admin 密码：admin888

Cron表达式说明

Cron表达式是一个字符串，字符串以空格隔开，分为5或6个域，每一个域代表一个含义，系统支持的表达式格式如下：

Seconds Minutes Hours DayofMonth Month [DayofWeek]

其中 DayofWeek 为可选域。

每一个域可出现的字符如下：

• Seconds: 可出现"* / , -"四个字符，有效范围为0-59的整数
• Minutes: 可出现"* / , -"四个字符，有效范围为0-59的整数
• Hours: 可出现"* / , -"四个字符，有效范围为0-23的整数
• DayofMonth: 可出现"* / , - ?"五个字符，有效范围为0-31的整数
• Month: 可出现", - * /"四个字符，有效范围为1-12的整数或JAN-DEC
• DayofWeek: 可出现"* / , - ?"五个字符，有效范围为0-6的整数或SUN-SAT两个范围。0表示星期天，1表示星期一， 依次类推

各个字符的含义如下：

• * 表示匹配该域的任意值，假如在Minutes域使用*, 即表示每分钟都会触发事件。
• ? 字符仅被用于天（月）和天（星期）两个子表达式，表示不指定值，当2个子表达式其中之一被指定了值以后，为了避免冲突，需要将另一个子表达式的值设为“?”。
• - 表示范围，例如在Minutes域使用5-20，表示从5分到20分钟每分钟触发一次。
• / 表示起始时间开始触发，然后每隔固定时间触发一次，例如在Minutes域使用5/20,则意味着5分钟触发一次，而25，45等分别触发一次。
• , 表示列出枚举值值。例如：在Minutes域使用5,20，则意味着在5和20分每分钟触发一次。

一些例子：

0 0 10,14,16 * * ? 每天上午10点，下午2点，4点触发 

0 0/30 9-17 * * ? 朝九晚五工作时间内每半小时触发  

0 0 12 ? * WED 表示每个星期三中午12点触发  

0 0 12 * * ? 每天中午12点触发 

0 15 10 ? * * 每天上午10:15触发 

0 15 10 * * ? 每天上午10:15触发 

0 15 10 * * ? * 每天上午10:15触发 

0 * 14 * * ? 在每天下午2点到下午2:59期间的每1分钟触发 

0 0/5 14 * * ? 在每天下午2点到下午2:55期间的每5分钟触发 

0 0/5 14,18 * * ? 在每天下午2点到2:55期间和下午6点到6:55期间的每5分钟触发 

0 0-5 14 * * ? 在每天下午2点到下午2:05期间的每1分钟触发 

0 10,44 14 ? 3 WED 每年三月的星期三的下午2:10和2:44触发 

0 15 10 ? * MON-FRI 周一至周五的上午10:15触发 

0 15 10 15 * ? 每月15日上午10:15触发 

0 15 10 L * ? 每月最后一日的上午10:15触发