Awesome
<p align="center"><a href="/" target="_blank" rel="noopener noreferrer"><img width="200" src="./static/logo.png" alt="gophercron logo"></a></p> <p align="center"> <img src="https://img.shields.io/badge/build-passing-brightgreen.svg" alt="Build Status"> <img src="https://img.shields.io/badge/package%20utilities-go modules-blue.svg" alt="Package Utilities"> <img src="https://img.shields.io/badge/golang-1.20.0-%23ff69b4.svg" alt="Version"> <img src="https://img.shields.io/badge/license-MIT-brightgreen.svg" alt="license"> </p> <h1 align="center">GopherCron</h1> 开箱即用的分布式可视化crontabDiscussions
依赖
- Etcd # 服务注册与发现
- Mysql # 任务日志存储
引用
- Gin 提供 webapi
- 🍉水瓜 提供服务注册发现能力(中心与边缘通信)
- gopherCronFe 提供可视化管理界面(已将构建后的文件内置于 dist/view 目录下)
- cronexpr 提供 cron 表达式解析器
实现功能
- 秒级定时任务(最细 5s 周期)
- 任务日志查看
- 随时结束任务进程
- 分布式扩展
- 健康节点检测 (分项目显示对应的健康节点 IP 及节点数)
- workflow 任务编排
监控面板
配套前端
项目地址 gopherCronFe
任务日志集中上报
1.10.x 版本中 client 配置增加了 report_addr 项,该配置接收一个 http 接口
配置后,任务日志将通过 http 发送到该地址进行集中处理
可通过请求中的 Head 参数 Report-Type 来判断是告警还是日志来做对应的处理
日志结构(参考:common/protocol.go 下的 TaskExecuteResult):
// TaskExecuteResult 任务执行结果
type TaskExecuteResult struct {
ExecuteInfo *TaskExecutingInfo `json:"execute_info"`
Output string `json:"output"` // 程序输出
Err string `json:"error"` // 是否发生错误
StartTime time.Time `json:"start_time"` // 开始时间
EndTime time.Time `json:"end_time"` // 结束时间
}
v2.1.0 + 版本中移除了 client 对 etcd 的依赖
日志上报相关代码参考 app/taskreport.go
cronexpr 秒级 cron 表达式介绍(引用)
* * * * * * *
Field name Mandatory? Allowed values Allowed special characters
---------- ---------- -------------- --------------------------
Seconds No 0-59 * / , -
Minutes Yes 0-59 * / , -
Hours Yes 0-23 * / , -
Day of month Yes 1-31 * / , - L W
Month Yes 1-12 or JAN-DEC * / , -
Day of week Yes 0-6 or SUN-SAT * / , - L #
Year No 1970–2099 * / , -
使用方法
下载项目到本地并编译,根据 cmd 文件夹下 service 和 client 中包含的 conf/config-default.toml 进行配置
初始化数据库表
建表语句在 pkg/store/sqlstore/table.sql
Admin 管理页面
访问地址: localhost:6306/admin
管理员初始账号密码为 admin 123456
注意
client 配置文件中的 project 配置需要用户先部署 service
在 service 中创建项目后可以获得项目 ID
需要将项目 ID 填写在 client 的配置中该 client 才会调度这个项目的任务