Sundial
.NET 功能齐全的开源分布式作业调度系统,可从最小的应用程序到大型企业系统使用。
特性
- 简化调度作业
- 支持作业监视器
- 支持作业执行器
- 支持自定义作业存储组件(持久化)
- 支持自定义策略执行
- 内置周期、Cron 作业
- 支持自定义作业触发器
- 支持依赖注入控制(含 HTTP 控制支持)
- 高内聚,低耦合,使代码更简单
- 很小,仅
41KB
- 无第三方依赖,TimeCrontab 也是本人作品
- 可在
Windows/Linux/MacOS
守护进程部署 - 支持分布式、集群(多实例)部署
- 支持负载均衡(基于 TCP/IP)
- 高质量代码和良好单元测试
- 跨平台,支持 .NET5+
安装
- Package Manager
Install-Package Sundial
- .NET CLI
dotnet add package Sundial
快速入门
我们在主页上有不少例子,这是让您入门的第一个:
- 定义作业,并实现
IJob
接口:
public class MyJob : IJob { private readonly ILogger<MyJob> _logger; public MyJob(ILogger<MyJob> logger) { _logger = logger; } public Task ExecuteAsync(JobExecutingContext context, CancellationToken stoppingToken) { _logger.LogInformation($"{context}"); return Task.CompletedTask; } }
- 在
Startup.cs
注册AddSchedule
服务和作业:
services.AddSchedule(options => { options.AddJob<MyJob>(Triggers.PeriodSeconds(5)); });
- 运行项目:
info: 2022-12-05 19:32:56.3835407 +08:00 星期一 L System.Logging.ScheduleService[0] #1 Schedule hosted service is running. info: 2022-12-05 19:32:56.3913451 +08:00 星期一 L System.Logging.ScheduleService[0] #1 Schedule hosted service is preloading... info: 2022-12-05 19:32:56.4322887 +08:00 星期一 L System.Logging.ScheduleService[0] #1 The <job1_trigger1> trigger for scheduler of <job1> successfully appended to the schedule. info: 2022-12-05 19:32:56.4347959 +08:00 星期一 L System.Logging.ScheduleService[0] #1 The scheduler of <job1> successfully appended to the schedule. warn: 2022-12-05 19:32:56.4504555 +08:00 星期一 L System.Logging.ScheduleService[0] #1 Schedule hosted service preload completed, and a total of <1> schedulers are appended. info: 2022-12-05 19:33:01.5100177 +08:00 星期一 L MyJob[0] #13 <job1> [C] <job1 job1_trigger1> 5s 1ts 2022-12-05 19:33:01.395 -> 2022-12-05 19:33:06.428 info: 2022-12-05 19:33:06.4676792 +08:00 星期一 L MyJob[0] #13 <job1> [C] <job1 job1_trigger1> 5s 2ts 2022-12-05 19:33:06.428 -> 2022-12-05 19:33:11.435 info: 2022-12-05 19:33:11.4460946 +08:00 星期一 L MyJob[0] #16 <job1> [C] <job1 job1_trigger1> 5s 3ts 2022-12-05 19:33:11.435 -> 2022-12-05 19:33:16.412
JobExecutionContext
重写了 ToString()
方法并提供以下几种格式:
# 持续运行格式 <作业Id> 作业描述 [并行C/串行S] <作业Id 触发器Id> 触发器字符串 触发器描述 触发次数ts 触发时间 -> 下一次触发时间 # 触发停止格式 <作业Id> 作业描述 [并行C/串行S] <作业Id 触发器Id> 触发器字符串 触发器描述 触发次数ts 触发时间 [触发器终止状态]
更多文档
文档
您可以在主页找到 Sundial 文档。
贡献
该存储库的主要目的是继续发展 Sundial 核心,使其更快、更易于使用。Sundial 的开发在 Gitee 上公开进行,我们感谢社区贡献错误修复和改进。
许可证
Sundial 采用 MIT 开源许可证。
文档地址:https://furion.baiqian.ltd/docs/job/
本期更新
-
新特性
- [新增] 定时任务
HTTP
作业,支持定时请求互联网URL
地址 4.8.7.7 ⏱️2023.03.11 01d4466 - [新增] 定时任务作业触发器
Trigger
执行结果Result
和执行耗时ElapsedTime
属性 4.8.7.7 ⏱️2023.03.11 01d4466 - [新增] 定时任务作业看板支持查看作业触发器执行结果
Result
和执行耗时ElapsedTime
属性 4.8.7.7 ⏱️2023.03.11 01d4466 - [新增] 定时任务休眠时长和唤醒时机日志输出 4.8.7.6 ⏱️2023.03.08 #I6LANE
- [新增] 定时任务
IScheduler.[Try]UpdateDetail(builder => {})
和IScheduler.[Try]UpdateTrigger(triggerId, builder => {})
重载方法 4.8.6 ⏱️2023.02.08 6e43a54 - [新增] 定时任务
Dashboard
可自定义入口地址/schedule
4.8.5.6 ⏱️2023.02.02 c5639f5 - [新增] 定时任务执行上下文
RunId
属性,用于标识单次作业触发器执行 4.8.5.1 ⏱️2023.01.30 1aac470 - [新增] 定时任务
Dashboard
查看作业触发器最近运行记录功能 4.8.4.3 ⏱️2023.01.03 e7d24d8 - [新增] 定时任务作业触发器
trigger.GetTimelines()
获取最近10
条运行记录列表 4.8.4.3 ⏱️2023.01.03 e7d24d8 - [新增] 定时任务
Dashboard
看板 4.8.4 ⏱️2022.12.30 d3f9669 - [新增] 定时任务
IScheduler.GetEnumerable()
方法,可将作业计划转换成可枚举字典 4.8.4 ⏱️2022.12.30 4d5235c - [新增] 定时任务配置选项
options.JobDetail.LogEnabled
配置,可自动输出执行日志 4.8.3.7 ⏱️2022.12.14 58d2c20 - [新增] 定时任务
IScheduler
对象每次操作后自动刷新和提供手动刷新Reload()
方法 4.8.3.3 ⏱️2022.12.09 #I65EQ1 - [新增] 定时任务间隔分钟作业触发器
Triggers.PeriodMinutes(5)
和[PeriodMinutes(5)]
特性 4.8.2.8 ⏱️2022.12.01 8e1f06f - [新增] 定时任务工作日作业触发器
Triggers.Workday()
和[Workday]
特性 4.8.2.6 ⏱️2022.11.30 28b2d20 - [新增] 定时任务作业校对功能,可对误差进行校正 4.8.2.6 ⏱️2022.11.30 f725a25
- [新增] 定时任务
Triggers
所有带At
的Cron
表达式触发器构建器及特性 4.8.2.5 ⏱️2022.11.29 #I63PLR - [新增] 定时任务批量添加
SchedulerBuilder
作业功能 4.8.2.4 ⏱️2022.11.29 5faa67b - [新增] 定时任务
BuildSqlType
配置,可设置生成不同数据库类型的SQL
语句 4.8.2.3 ⏱️2022.11.29 293f9bc !675 - [新增]
JobDetail
和Trigger
自定义ConvertToSQL
输出SQL
配置 4.8.2 ⏱️2022.11.27 0bb9d8f - [新增] 作业触发器
ResetOnlyOnce
属性,支持只运行一次的作业重新启动服务重复执行 4.8.1.5 ⏱️2022.11.25 a8be728 - [新增] 动态作业处理程序委托支持 4.8.1.8 ⏱️2022.11.27 e02266c
- [新增] 定时任务
-
突破性变化
- [调整] 定时任务底层所有代码,日志,注释,文档 4.8.1.10 ⏱️2022.12.05
-
问题修复
- [修复] 定时任务服务在停止进程时会卡住
30秒
问题 4.8.7.8 ⏱️2023.03.13 #I6MI9I #I6MHOU - [修复] 定时任务看板删除不存在的作业触发器出现空异常 4.8.7.7 ⏱️2023.03.11 01d4466
- [修复] 定时任务
StartAll
出现个别作业显示无触发时间
的状态 4.8.4.14 ⏱️2023.01.12 #I6A08X - [修复] 定时任务停止作业触发器后运行记录不能写入最新记录问题 4.8.4.8 ⏱️2023.01.05 d4c553f
- [修复] 定时任务使用
Furion.Pure
包访问Dashboard
出现404
问题 4.8.4.2 ⏱️2023.01.02 21977b7 - [修复] 定时任务通过
scheduler.RemoveTrigger(triggerId)
报异常问题 4.8.3.3 ⏱️2022.12.09 #I65EQ1 - [修复] 定时任务作业触发器配置了
EndTime
和StartTime
之后Status
没有对应上 4.8.3.1 ⏱️2022.12.09 52a5506 - [修复] 定时任务通过
scheduler.AddTrigger(triggerBuilder)
无效的问题 4.8.3.1 ⏱️2022.12.09 #I65EQ1 - [修复] 作业拥有多个触发器时暂停作业后依然存在个别未暂停的清空(并发问题) 4.8.2.12 ⏱️2022.12.07 #I655W9
- [修复] 作业触发器不符合下一次执行规律但
NextRunTime
不为null
情况 4.8.1.5 ⏱️2022.11.25 a8be728 - [修复] 运行时启动/暂停作业无效问题 4.8.1.6 ⏱️2022.11.25 #I6368M
- [修复] 定时任务生成的
SQL
语句不支持MySQL
问题 4.8.1.7 ⏱️2022.11.26 #I638ZC
- [修复] 定时任务服务在停止进程时会卡住
-
其他更改
- [调整] 定时任务查看作业触发器运行记录由保存
10条
改为5条
4.8.7.7 ⏱️2023.03.07 01d4466 - [调整] 定时任务调度器时间精度,控制持续执行一年误差在
100ms
以内 4.8.2.9 ⏱️2022.12.01 334d089 - [调整] 定时任务作业计划工厂
GetNextRunJobs()
方法逻辑 4.8.2.7 ⏱️2022.11.30 #I63VS2
- [调整] 定时任务查看作业触发器运行记录由保存
-
文档
- [新增] 作业执行器实现超时文档 4.8.3.8 ⏱️2022.12.20
- [新增] 作业触发器
ResetOnlyOnce
文档 4.8.1.5 ⏱️2022.11.25 a8be728 - [新增] 通过
Roslyn
动态编译代码创建IJob
类型文档 4.8.1.5 ⏱️2022.11.25 2c5e5be - [新增] 自定义
JobDetail
和Trigger
输出SQL
文档 4.8.2 ⏱️2022.11.27 0bb9d8f