gocron/README.md

[![Build Status](https://travis-ci.org/ouqiang/gocron.png)](https://travis-ci.org/ouqiang/gocron)
# gocron - 定时任务web管理系统

# 项目简介
使用Go语言开发的定时任务集中调度和管理系统, 用于替代Linux-crontab [查看文档](https://github.com/ouqiang/gocron/wiki)

## 功能特性
* 支持任务CURD
* crontab时间表达式，精确到秒
* 任务执行失败重试设置
* 任务超时设置
* 任务执行方式
    * 调用本机系统命令  
    * 通过SSH执行远程命令
    * 执行HTTP-GET请求
* 查看任务执行日志
* 任务执行结果通知, 支持邮件、Slack

### 截图
![任务](https://raw.githubusercontent.com/ouqiang/gocron/master/screenshot_task.png)
![Slack](https://raw.githubusercontent.com/ouqiang/gocron/master/screenshot_slack.png)
    
### 支持平台
> Windows、Linux、Mac OS

### 环境要求
>  MySQL


## 下载
* [Linux-64位](http://opns468ov.bkt.clouddn.com/gocron/gocron-linux-amd64.tar.gz)
* [Mac OS-64位](http://opns468ov.bkt.clouddn.com/gocron/gocron-darwin-amd64.tar.gz)
* [Windows-64位](http://opns468ov.bkt.clouddn.com/gocron/gocron-windows-amd64.zip)

## 安装

###  二进制安装
1. 解压压缩包    
2. `cd 解压目录`   
3. 启动  
    * Windows:  `gocron.exe web`            
    * Linux、Mac OS:  `./gocron web`
4. 浏览器访问 http://localhost:5920
### 源码安装
1. `go`语言版本1.7+
2. `go get -d github.com/ouqiang/gocron`
3. 编译 `go build`
4. 启动、访问方式同上

### 启动可选参数

* -p 端口, 指定端口, 默认5920
* -e 指定运行环境, dev|test|prod, dev模式下可查看更多日志信息, 默认prod
* -h 查看帮助

## 安全
* 使用`https`访问保证数据传输安全, 可在web服务器如nginx中配置https，通过反向代理，访问内部的gocron
* 网站访问设置IP白名单
* SSH登录设置IP白名单

## 程序使用的组件
* web框架 [Macaron](http://go-macaron.com/)
* 定时任务调度 [cron](https://github.com/robfig/cron)
* ORM [Xorm](https://github.com/go-xorm/xorm)
* UI框架 [Semantic UI](https://semantic-ui.com/)
* 依赖管理(所有依赖包放入vendor目录) [govendor](https://github.com/kardianos/govendor)

## 贡献
欢迎提交PR
-												完善README

											
										
										
											2017-04-28 08:09:07 +00:00
+								[![Build Status](https://travis-ci.org/ouqiang/gocron.png)](https://travis-ci.org/ouqiang/gocron)
-												完善README

											
										
										
											2017-04-28 08:06:06 +00:00
+								# gocron - 定时任务web管理系统
-												增加ci构建状态显示

											
										
										
											2017-04-05 12:06:51 +00:00
-												安装系统页面,不显示导航栏

											
										
										
											2017-05-04 08:50:41 +00:00
+								# 项目简介
-												应用优雅退出

											
										
										
											2017-05-04 10:05:25 +00:00
+								使用Go语言开发的定时任务集中调度和管理系统, 用于替代Linux-crontab [查看文档](https://github.com/ouqiang/gocron/wiki)
-												安装系统页面,不显示导航栏

											
										
										
											2017-05-04 08:50:41 +00:00
-												完善README

											
										
										
											2017-04-28 08:06:06 +00:00
+								## 功能特性
-												增加邮件通知

											
										
										
											2017-04-30 17:12:07 +00:00
+								* 支持任务CURD
-												HTTP任务执行时间不能超过300秒

											
										
										
											2017-05-09 05:42:49 +00:00
+								* crontab时间表达式，精确到秒
-												完善README

											
										
										
											2017-04-28 08:06:06 +00:00
+								* 任务执行失败重试设置
 								* 任务超时设置
 								* 任务执行方式
 								    * 调用本机系统命令
 								    * 通过SSH执行远程命令
 								    * 执行HTTP-GET请求
 								* 查看任务执行日志
 								* 任务执行结果通知, 支持邮件、Slack
-												新增界面截图

											
										
										
											2017-04-30 23:12:39 +00:00
 								### 截图
-												修改截图路径

											
										
										
											2017-05-02 13:09:48 +00:00
+								![任务](https://raw.githubusercontent.com/ouqiang/gocron/master/screenshot_task.png)
 								![Slack](https://raw.githubusercontent.com/ouqiang/gocron/master/screenshot_slack.png)
-												完善README

											
										
										
											2017-04-28 08:06:06 +00:00
 								### 支持平台
-												HTTP任务执行时间不能超过300秒

											
										
										
											2017-05-09 05:42:49 +00:00
+								> Windows、Linux、Mac OS
-												完善README

											
										
										
											2017-04-28 08:06:06 +00:00
 								### 环境要求
 								>  MySQL
-												完善文档

											
										
										
											2017-05-10 03:59:47 +00:00
+								## 下载
 								* [Linux-64位](http://opns468ov.bkt.clouddn.com/gocron/gocron-linux-amd64.tar.gz)
 								* [Mac OS-64位](http://opns468ov.bkt.clouddn.com/gocron/gocron-darwin-amd64.tar.gz)
 								* [Windows-64位](http://opns468ov.bkt.clouddn.com/gocron/gocron-windows-amd64.zip)
-												完善README

											
										
										
											2017-04-28 08:06:06 +00:00
+								## 安装
-												完善文档

											
										
										
											2017-05-10 03:59:47 +00:00
-												完善README

											
										
										
											2017-04-28 08:06:06 +00:00
+								###  二进制安装
-												完善文档

											
										
										
											2017-05-10 03:59:47 +00:00
+. 解压压缩包
 . `cd 解压目录`
 . 启动
-												修复文档错误

											
										
										
											2017-05-01 07:23:00 +00:00
+								    * Windows:  `gocron.exe web`
-												HTTP任务执行时间不能超过300秒

											
										
										
											2017-05-09 05:42:49 +00:00
+								    * Linux、Mac OS:  `./gocron web`
-												完善文档

											
										
										
											2017-05-10 03:59:47 +00:00
+. 浏览器访问 http://localhost:5920
-												完善README

											
										
										
											2017-04-28 08:06:06 +00:00
+								### 源码安装
-												CI配置-Go语言版本要求1.7+

											
										
										
											2017-05-05 09:34:10 +00:00
+. `go`语言版本1.7+
-												增加删除N个月前的任务日志API

											
										
										
											2017-05-10 08:09:10 +00:00
+. `go get -d github.com/ouqiang/gocron`
-												完善文档

											
										
										
											2017-05-02 13:49:38 +00:00
+. 编译 `go build`
 . 启动、访问方式同上
-												完善README

											
										
										
											2017-04-28 08:06:06 +00:00
 								### 启动可选参数
 								* -p 端口, 指定端口, 默认5920
 								* -e 指定运行环境, dev|test|prod, dev模式下可查看更多日志信息, 默认prod
 								* -h 查看帮助
 								## 安全
 								* 使用`https`访问保证数据传输安全, 可在web服务器如nginx中配置https，通过反向代理，访问内部的gocron
 								* 网站访问设置IP白名单
-												修复文档错误

											
										
										
											2017-05-01 07:23:00 +00:00
+								* SSH登录设置IP白名单
-												完善文档

											
										
										
											2017-05-07 03:38:03 +00:00
-												完善文档

											
										
										
											2017-05-09 09:34:28 +00:00
+								## 程序使用的组件
 								* web框架 [Macaron](http://go-macaron.com/)
 								* 定时任务调度 [cron](https://github.com/robfig/cron)
 								* ORM [Xorm](https://github.com/go-xorm/xorm)
 								* UI框架 [Semantic UI](https://semantic-ui.com/)
 								* 依赖管理(所有依赖包放入vendor目录) [govendor](https://github.com/kardianos/govendor)
-												完善文档

											
										
										
											2017-05-07 03:38:03 +00:00
+								## 贡献
-												完善文档

											
										
										
											2017-05-09 09:34:28 +00:00
+								欢迎提交PR