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 开源许可证。
本期更新
- [新增] 定时任务看板支持自定义刷新频率 SyncRate 功能 4.8.7.43 ⏱️2023.04.12 703b465
- [新增] 定时任务看板支持完全自定义 RequestPath 入口地址功能 4.8.7.34 ⏱️2023.04.04 24736f6
- [新增] 定时任务一系列 .AlterTo 修改作业触发器触发时间便捷方法 4.8.7.31 ⏱️2023.03.31 0349017
- [新增] 定时任务看板 UI 作业列表 最近执行时间 列和优化显示效果 4.8.7.12 ⏱️2023.03.15 26462a8 cb5dd17
- [新增] 定时任务作业计划/工厂立即执行 RunJob 方法 4.8.7.11 ⏱️2023.03.15版本号UI 提供立即执行功能 4.8.7.11 ⏱️2023.03.15版本号JobExecutionContext 服务提供器 ServiceProvider 属性 4.8.7.10 ⏱️2023.03.14 02586f8
- [新增] 定时任务 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版本号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版本号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版本号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
-
突破性变化
- [调整] 定时任务动态作业 DynamicJob 委托/方法签名 4.8.7.10 ⏱️2023.03.14 6d56b53
- [调整] 定时任务底层所有代码，日志，注释，文档 4.8.1.10 ⏱️2022.12.05
新特性
问题修复
- [修复] 定时任务通过作业 Id 删除作业不能删除作业触发器问题 4.8.7.35 ⏱️2023.04.05 312ca35