.NET?Core?分布式任務(wù)調(diào)度ScheduleMaster詳解
1.什么是ScheduleMaster
ScheduleMaster是分布式任務(wù)調(diào)度
系統(tǒng),是國內(nèi)的一位開發(fā)者寫的。簡稱:集中任務(wù)調(diào)度系統(tǒng),最簡單的理解ScheduleMaster,就是對不同的系統(tǒng)里面的調(diào)度任務(wù)做統(tǒng)一管理的框架。
例如我們現(xiàn)在有多個系統(tǒng),每個系統(tǒng)針對自己處理不同的業(yè)務(wù)場景。衍生出自己的調(diào)度任務(wù),想象一下,如果每個系統(tǒng)人為去維護(hù),那隨著調(diào)度任務(wù)越來越多,人是崩潰的吧,可見維護(hù)和技術(shù)成本是巨大的,這時我們需要選擇分布式任務(wù)系統(tǒng)框架做統(tǒng)一的管理
當(dāng)然有目前有很多相對優(yōu)秀分布式任務(wù)系統(tǒng)框架,我們主要學(xué)習(xí) ScheduleMaster
2.使用ScheduleMaster
1.首先我們需要使用NET Core web Api創(chuàng)建幾個模擬的微服務(wù),分別為 考勤、算薪、郵件、短信
2.下載開源的ScheduleMaster,并且使用ScheduleMaster調(diào)度我們的微服務(wù)接口
- sqlserver:"Persist Security Info = False; User ID =sa; Password =123456; Initial Catalog =schedule_master; Server =."
- postgresql:"Server=localhost;Port=5432;Database=schedule_master;User Id=postgres;Password=123456;Pooling=true;MaxPoolSize=20;"
- mysql:"Data Source=localhost;Database=schedule_master;User ID=root;Password=123456;pooling=true;CharSet=utf8mb4;port=3306;sslmode=none;TreatTinyAsBoolean=true"
修改Host的配置文件和支持的數(shù)據(jù)庫,框架默認(rèn)使用Mysql
修改Web的配置文件和支持的數(shù)據(jù)庫,框架默認(rèn)使用Mysql
3.進(jìn)入Hos.ScheduleMaster.Web項目的發(fā)布目錄,dotnet Hos.ScheduleMaster.Web.dll
啟動項目 ,此時會生成數(shù)據(jù)庫
登錄賬號:admin
密碼:111111
4.進(jìn)入Hos.ScheduleMaster.QuartzHost項目的發(fā)布目錄,執(zhí)行命令,啟動項目
dotnet Hos.ScheduleMaster.QuartzHost.dll --urls http://*:30003
1.配置Http調(diào)度任務(wù)
5.準(zhǔn)備就緒后,使用后臺查看節(jié)點管理,可以看到web主節(jié)點30000和任務(wù)調(diào)度的接口30002已經(jīng)在運行
6.使用任務(wù)列表菜單,創(chuàng)建定時調(diào)度任務(wù),配置基礎(chǔ)信息和元數(shù)據(jù)配置,然后點擊保存就開始執(zhí)行任務(wù)
2.配置程序集調(diào)度任務(wù)
1.創(chuàng)建一個類庫,安裝ScheduleMaster庫, 創(chuàng)建一個類繼承TaskBase,實現(xiàn)抽象方法,然后編譯程序集
namespace TaskExcuteService { class AssemblyTask : TaskBase { public override void Run(TaskContext context) { context.WriteLog("程序集任務(wù)"); } } }
2.找到debug目錄,去掉Base程序集,然后添加為壓縮文件
3.在web界面找到任務(wù)配置,選擇程序集進(jìn)行基本配置,配置元數(shù)據(jù),輸入程序集名稱,然后輸入類,并將程序集上傳,保存就可以運行了
3.使用Api接入任務(wù)
為了方便業(yè)務(wù)系統(tǒng)更好的接入調(diào)度系統(tǒng),ScheduleMaster創(chuàng)建任務(wù)不僅可以在控制臺中實現(xiàn),系統(tǒng)也提供了WebAPI供業(yè)務(wù)系統(tǒng)使用代碼接入,這種方式對延時任務(wù)來說尤其重要。
1.API Server 對接流程
- 在控制臺中創(chuàng)建好專用的API對接用戶賬號。
- 使用對接賬號的用戶名設(shè)置為http header中的
ms_auth_user
值。 - 使用經(jīng)過哈希運算過的秘鑰設(shè)置為http header中的
ms_auth_secret值
,計算規(guī)則:按{用戶名}{hash(密碼)}{用戶名}的格式拼接得到字符串str,然后再對str做一次hash運算即得到最終秘鑰,hash函數(shù)是小寫的32位MD5算法。 - 使用form格式發(fā)起http調(diào)用,如果非法用戶會返回401-Unauthorized。
HttpClient client = new HttpClient(); client.DefaultRequestHeaders.Add("ms_auth_user", "admin"); client.DefaultRequestHeaders.Add("ms_auth_secret", SecurityHelper.MD5($"admin{SecurityHelper.MD5("111111")}}admin"));
所有接口采用統(tǒng)一的返回格式,字段如下:
參數(shù)名稱 | 參數(shù)類型 | 說明 |
---|---|---|
Success | bool | 是否成功 |
Status | int | 結(jié)果狀態(tài),0-請求失敗 1-請求成功 2-登錄失敗 3-參數(shù)異常 4-數(shù)據(jù)異常 |
Message | string | 返回的消息 |
Data | object | 返回的數(shù)據(jù) |
2.創(chuàng)建程序集任務(wù)
使用API創(chuàng)建任務(wù)的方式不支持上傳程序包,所以在任務(wù)需要啟動時要確保程序包已通過其他方式上傳,否則會啟動失敗。
- 接口地址:
http://yourip:30000/api/task/create
- 請求類型:
POST
- 參數(shù)格式:
application/x-www-form-urlencoded
- 返回結(jié)果:創(chuàng)建成功返回任務(wù)id
- 參數(shù)列表:
參數(shù)名稱 | 參數(shù)類型 | 是否必填 | 說明 |
---|---|---|---|
MetaType | int | 是 | 任務(wù)類型,這里固定是1 |
Title | string | 是 | 任務(wù)名稱 |
RunLoop | bool | 是 | 是否按周期執(zhí)行 |
CronExpression | string | 否 | cron表達(dá)式,如果RunLoop為true則必填 |
AssemblyName | string | 是 | 程序集名稱 |
ClassName | string | 是 | 執(zhí)行類名稱,包含完整命名空間 |
StartDate | DateTime | 是 | 任務(wù)開始時間 |
EndDate | DateTime | 否 | 任務(wù)停止時間,為空表示不限停止時間 |
Remark | string | 否 | 任務(wù)描述說明 |
Keepers | List<int> | 否 | 監(jiān)護(hù)人id |
Nexts | List<guid> | 否 | 子級任務(wù)id |
Executors | List<string> | 否 | 執(zhí)行節(jié)點名稱 |
RunNow | bool | 否 | 創(chuàng)建成功是否立即啟動 |
Params | List<ScheduleParam> | 否 | 自定義參數(shù)列表,也可以通過CustomParamsJson字段直接傳json格式字符串 |
ScheduleParam:
參數(shù)名稱 | 參數(shù)類型 | 是否必填 | 說明 |
---|---|---|---|
ParamKey | string | 是 | 參數(shù)名稱 |
ParamValue | string | 是 | 參數(shù)值 |
ParamRemark | string | 否 | 參數(shù)說明 |
HttpClient client = new HttpClient(); List<KeyValuePair<string, string>> args = new List<KeyValuePair<string, string>>(); args.Add(new KeyValuePair<string, string>("MetaType", "1")); args.Add(new KeyValuePair<string, string>("RunLoop", "true")); args.Add(new KeyValuePair<string, string>("CronExpression", "33 0/8 * * * ?")); args.Add(new KeyValuePair<string, string>("Remark", "By Xunit Tester Created")); args.Add(new KeyValuePair<string, string>("StartDate", DateTime.Today.ToString("yyyy-MM-dd HH:mm:ss"))); args.Add(new KeyValuePair<string, string>("Title", "程序集接口測試任務(wù)")); args.Add(new KeyValuePair<string, string>("AssemblyName", "Hos.ScheduleMaster.Demo")); args.Add(new KeyValuePair<string, string>("ClassName", "Hos.ScheduleMaster.Demo.Simple")); args.Add(new KeyValuePair<string, string>("CustomParamsJson", "[{\"ParamKey\":\"k1\",\"ParamValue\":\"1111\",\"ParamRemark\":\"r1\"},{\"ParamKey\":\"k2\",\"ParamValue\":\"2222\",\"ParamRemark\":\"r2\"}]")); args.Add(new KeyValuePair<string, string>("Keepers", "1")); args.Add(new KeyValuePair<string, string>("Keepers", "2")); //args.Add(new KeyValuePair<string, string>("Nexts", "")); //args.Add(new KeyValuePair<string, string>("Executors", "")); HttpContent reqContent = new FormUrlEncodedContent(args); var response = await client.PostAsync("http://localhost:30000/api/Task/Create", reqContent); var content = await response.Content.ReadAsStringAsync(); Debug.WriteLine(content);
3.創(chuàng)建HTTP任務(wù)
- 接口地址:
http://yourip:30000/api/task/create
- 請求類型:
POST
- 參數(shù)格式:
application/x-www-form-urlencoded
- 返回結(jié)果:創(chuàng)建成功返回任務(wù)id
- 參數(shù)列表:
參數(shù)名稱 | 參數(shù)類型 | 是否必填 | 說明 |
---|---|---|---|
MetaType | int | 是 | 任務(wù)類型,這里固定是2 |
Title | string | 是 | 任務(wù)名稱 |
RunLoop | bool | 是 | 是否按周期執(zhí)行 |
CronExpression | string | 否 | cron表達(dá)式,如果RunLoop為true則必填 |
StartDate | DateTime | 是 | 任務(wù)開始時間 |
EndDate | DateTime | 否 | 任務(wù)停止時間,為空表示不限停止時間 |
Remark | string | 否 | 任務(wù)描述說明 |
HttpRequestUrl | string | 是 | 請求地址 |
HttpMethod | string | 是 | 請求方式,僅支持GET\POST\PUT\DELETE |
HttpContentType | string | 是 | 參數(shù)格式,僅支持application/json和application/x-www-form-urlencoded |
HttpHeaders | string | 否 | 自定義請求頭,ScheduleParam列表的json字符串 |
HttpBody | string | 是 | 如果是json格式參數(shù),則是對應(yīng)參數(shù)的json字符串;如果是form格式參數(shù),則是對應(yīng)ScheduleParam列表的json字符串。 |
Keepers | List<int> | 否 | 監(jiān)護(hù)人id |
Nexts | List<guid> | 否 | 子級任務(wù)id |
Executors | List<string> | 否 | 執(zhí)行節(jié)點名稱 |
RunNow | bool | 否 | 創(chuàng)建成功是否立即啟動 |
HttpClient client = new HttpClient(); List<KeyValuePair<string, string>> args = new List<KeyValuePair<string, string>>(); args.Add(new KeyValuePair<string, string>("MetaType", "2")); args.Add(new KeyValuePair<string, string>("RunLoop", "true")); args.Add(new KeyValuePair<string, string>("CronExpression", "22 0/8 * * * ?")); args.Add(new KeyValuePair<string, string>("Remark", "By Xunit Tester Created")); args.Add(new KeyValuePair<string, string>("StartDate", DateTime.Today.ToString("yyyy-MM-dd HH:mm:ss"))); args.Add(new KeyValuePair<string, string>("Title", "Http接口測試任務(wù)")); args.Add(new KeyValuePair<string, string>("HttpRequestUrl", "http://localhost:56655/api/1.0/value/jsonpost")); args.Add(new KeyValuePair<string, string>("HttpMethod", "POST")); args.Add(new KeyValuePair<string, string>("HttpContentType", "application/json")); args.Add(new KeyValuePair<string, string>("HttpHeaders", "[]")); args.Add(new KeyValuePair<string, string>("HttpBody", "{ \"Posts\": [{ \"PostId\": 666, \"Title\": \"tester\", \"Content\":\"testtesttest\" }], \"BlogId\": 111, \"Url\":\"qweqrrttryrtyrtrtrt\" }")); HttpContent reqContent = new FormUrlEncodedContent(args); var response = await client.PostAsync("http://localhost:30000/api/Task/Create", reqContent); var content = await response.Content.ReadAsStringAsync(); Debug.WriteLine(content);
4.創(chuàng)建延時任務(wù)
- 接口地址:
http://yourip:30000/api/delaytask/create
- 請求類型:
POST
- 參數(shù)格式:
application/x-www-form-urlencoded
- 返回結(jié)果:創(chuàng)建成功返回任務(wù)id
- 參數(shù)列表:
參數(shù)名稱 | 參數(shù)類型 | 是否必填 | 說明 |
---|---|---|---|
SourceApp | string | 是 | 來源 |
Topic | string | 是 | 主題 |
ContentKey | string | 是 | 業(yè)務(wù)關(guān)鍵字 |
DelayTimeSpan | int | 是 | 延遲相對時間 |
DelayAbsoluteTime | DateTime | 是 | 延遲絕對時間 |
NotifyUrl | string | 是 | 回調(diào)地址 |
NotifyDataType | string | 是 | 回調(diào)參數(shù)格式,僅支持application/json和application/x-www-form-urlencoded |
NotifyBody | string | 是 | 回調(diào)參數(shù),json格式字符串 |
for (int i = 0; i < 5; i++) { int rndNum = new Random().Next(20, 500); List<KeyValuePair<string, string>> args = new List<KeyValuePair<string, string>>(); args.Add(new KeyValuePair<string, string>("SourceApp", "TestApp")); args.Add(new KeyValuePair<string, string>("Topic", "TestApp.Trade.TimeoutCancel")); args.Add(new KeyValuePair<string, string>("ContentKey", i.ToString())); args.Add(new KeyValuePair<string, string>("DelayTimeSpan", rndNum.ToString())); args.Add(new KeyValuePair<string, string>("DelayAbsoluteTime", DateTime.Now.AddSeconds(rndNum).ToString("yyyy-MM-dd HH:mm:ss"))); args.Add(new KeyValuePair<string, string>("NotifyUrl", "http://localhost:56655/api/1.0/value/delaypost")); args.Add(new KeyValuePair<string, string>("NotifyDataType", "application/json")); args.Add(new KeyValuePair<string, string>("NotifyBody", "{ \"Posts\": [{ \"PostId\": 666, \"Title\": \"tester\", \"Content\":\"testtesttest\" }], \"BlogId\": 111, \"Url\":\"qweqrrttryrtyrtrtrt\" }")); HttpContent reqContent = new FormUrlEncodedContent(args); var response = await client.PostAsync("http://localhost:30000/api/DelayTask/Create", reqContent); var content = await response.Content.ReadAsStringAsync(); Debug.WriteLine(content); }
4.框架簡單分析
1.全局設(shè)計
根據(jù)官網(wǎng)的設(shè)計圖,以及操作的流程,簡單總結(jié)一下任務(wù)全局流程為客戶端—–>master——>work—–>執(zhí)行任務(wù)。從大的架構(gòu)方向的思想就是,將原有單個服務(wù)中業(yè)務(wù)和任務(wù)調(diào)度混合的方式做一些改變,使業(yè)務(wù)和調(diào)度分離,專門把任務(wù)調(diào)度部分剝離出來,作為一個獨立的進(jìn)程,來統(tǒng)一調(diào)用和管理任務(wù),而原有服務(wù)只做業(yè)務(wù)處理。
2.Master和Work分析
我們主要從主節(jié)點,從節(jié)點,數(shù)據(jù)表這幾個方面來簡單分析,整個業(yè)務(wù)的時序流程,從本質(zhì)來看并不復(fù)雜master和Work之間的關(guān)系是相互配合的,可能乍一看下面整個圖有點混亂,下面來解釋一下,其實Master節(jié)點將任務(wù)添加到數(shù)據(jù)中,然后work節(jié)點,去從對應(yīng)的數(shù)據(jù)表中取出任務(wù)數(shù)據(jù),然后根據(jù)任務(wù)對應(yīng)的配置,生成配置信息,調(diào)用Quartz執(zhí)行任務(wù),這就是我們整個框架中最核心的業(yè)務(wù)。
當(dāng)然master和work除了主要承載了整個管理系統(tǒng)的UI可視化、后臺業(yè)務(wù)操作、任務(wù)執(zhí)行之外,如果從細(xì)節(jié)以及實現(xiàn)方式來說主要做了以下事情:
Master
- 1.分配任務(wù)執(zhí)行和選擇節(jié)點
- 2.對work節(jié)點進(jìn)行健康檢查,對任務(wù)進(jìn)行故障轉(zhuǎn)移
Work
- 1.取出任務(wù)配置信息
- 2.使用Quartz根據(jù)配置運行任務(wù)
- 3.使用反射調(diào)用程序集
- 4.使用httpclient調(diào)用http 接口
到此這篇關(guān)于分布式任務(wù)調(diào)度ScheduleMaster的文章就介紹到這了,更多相關(guān)分布式任務(wù)調(diào)度ScheduleMaster內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
插件下載┊垃圾引用防御補?。啃r自動換KEY,支持靜態(tài)頁面)
插件下載┊垃圾引用防御補?。啃r自動換KEY,支持靜態(tài)頁面)...2007-02-02