分佈式任務調度xxl-job問題解決

Posted on 2022-03-05 by WalkonNet

前言

在單機應用時期，任務調度一般都是基於spring schedule和集成quartz來實現的，當系統發展成分佈式服務，應用多實例的時候，任務就會出現多次調用的問題，很多時候我們任務並不需要跑多次。解決方案有很多，最最簡單粗暴的就是可以設置應用開關。其次就是集中式話任務管理調度。當然，quartz也有集群模式，但是基於api控制並不直觀。下面介紹一個集中式的分佈式任務調度框架，可以很方便的解決分佈式任務調度的問題

xxl-job簡介

XXL-JOB是一個輕量級分佈式任務調度框架，其核心設計目標是開發迅速、學習簡單、輕量級、易擴展。現已開放源代碼並接入多傢公司線上產品線，開箱即用。

功能如下

1、簡單：支持通過Web頁面對任務進行CRUD操作，操作簡單，一分鐘上手；

2、動態：支持動態修改任務狀態、暫停/恢復任務，以及終止運行中任務，即時生效；

3、調度中心HA（中心式）：調度采用中心式設計，“調度中心”基於集群Quartz實現，可保證調度中心HA；

4、執行器HA（分佈式）：任務分佈式執行，任務"執行器"支持集群部署，可保證任務執行HA；

5、任務Failover：執行器集群部署時，任務路由策略選擇"故障轉移"情況下調度失敗時將會平滑切換執行器進行Failover；

6、一致性：“調度中心”通過DB鎖保證集群分佈式調度的一致性, 一次任務調度隻會觸發一次執行；

7、自定義任務參數：支持在線配置調度任務入參，即時生效；

8、調度線程池：調度系統多線程觸發調度運行，確保調度精確執行，不被堵塞；

9、彈性擴容縮容：一旦有新執行器機器上線或者下線，下次調度時將會重新分配任務；

10、郵件報警：任務失敗時支持郵件報警，支持配置多郵件地址群發報警郵件；

11、狀態監控：支持實時監控任務進度；

12、Rolling執行日志：支持在線查看調度結果，並且支持以Rolling方式實時查看執行器輸出的完整的執行日志；

13、GLUE：提供Web IDE，支持在線開發任務邏輯代碼，動態發佈，實時編譯生效，省略部署上線的過程。支持30個版本的歷史版本回溯。

14、數據加密：調度中心和執行器之間的通訊進行數據加密，提升調度信息安全性；

15、任務依賴：支持配置子任務依賴，當父任務執行結束且執行成功後將會主動觸發一次子任務的執行, 多個子任務用逗號分隔；

16、推送maven中央倉庫: 將會把最新穩定版推送到maven中央倉庫, 方便用戶接入和使用;

17、任務註冊: 執行器會周期性自動註冊任務, 調度中心將會自動發現註冊的任務並觸發執行。同時，也支持手動錄入執行器地址；

18、路由策略：執行器集群部署時提供豐富的路由策略，包括：第一個、最後一個、輪詢、隨機、一致性HASH、最不經常使用、最近最久未使用、故障轉移、忙碌轉移等；

19、運行報表：支持實時查看運行數據，如任務數量、調度次數、執行器數量等；以及調度報表，如調度日期分佈圖，調度成功分佈圖等；

20、腳本任務：支持以GLUE模式開發和運行腳本任務，包括Shell、Python等類型腳本;

21、阻塞處理策略：調度過於密集執行器來不及處理時的處理策略，策略包括：單機串行（默認）、丟棄後續調度、覆蓋之前調度；

22、失敗處理策略；調度失敗時的處理策略，策略包括：失敗告警（默認）、失敗重試；

23、分片廣播任務：執行器集群部署時，任務路由策略選擇"分片廣播"情況下，一次任務調度將會廣播觸發集群中所有執行器執行一次任務，可根據分片參數開發分片任務；

24、動態分片：分片廣播任務以執行器為維度進行分片，支持動態擴容執行器集群從而動態增加分片數量，協同進行業務處理；在進行大數據量業務操作時可顯著提升任務處理能力和速度。

25、事件觸發：除瞭"Cron方式"和"任務依賴方式"觸發任務執行之外，支持基於事件的觸發任務方式。調度中心提供觸發任務單次執行的API服務，可根據業務事件靈活觸發。

快速入門

項目地址為：https://github.com/xuxueli/xxl-job

2.1 初始化“調度數據庫”

請下載項目源碼並解壓，獲取 "調度數據庫初始化SQL腳本" 並執行即可，正常情況下應該生成16張表。

"調度數據庫初始化SQL腳本" 位置為:

/xxl-job/doc/db/tables_xxl_job.sql

調度中心支持集群部署，集群情況下各節點務必連接同一個mysql實例;

如果mysql做主從,調度中心集群節點務必強制走主庫;

2.2 編譯源碼

解壓源碼,按照maven格式將源碼導入IDE, 使用maven進行編譯即可，源碼結構如下：

xxl-job-admin：調度中心
xxl-job-core：公共依賴
xxl-job-executor：執行器Sample示例（選擇合適的版本執行器，可直接使用，也可以參考其並將現有項目改造成執行器）
：xxl-job-executor-sample-spring：Spring版本，通過Spring容器管理執行器，比較通用，推薦這種方式；
：xxl-job-executor-sample-springboot：Springboot版本，通過Springboot管理執行器；
：xxl-job-executor-sample-jfinal：JFinal版本，通過JFinal管理執行器；

2.3 配置部署“調度中心”

調度中心項目：xxl-job-admin
作用：統一管理任務調度平臺上調度任務，負責觸發調度執行，並且提供任務管理平臺。

步驟一：調度中心配置：

調度中心配置文件地址：

/xxl-job/xxl-job-admin/src/main/resources/xxl-job-admin.properties

調度中心配置內容說明：

### 調度中心JDBC鏈接：鏈接地址請保持和 2.1章節所創建的調度數據庫的地址一致

xxl.job.db.driverClass=com.mysql.jdbc.Driver
xxl.job.db.url=jdbc:mysql://localhost:3306/xxl-job?useUnicode=true&characterEncoding=UTF-8
xxl.job.db.user=root
xxl.job.db.password=root_pwd

### 報警郵箱

xxl.job.mail.host=smtp.163.com
xxl.job.mail.port=25
[email protected]
xxl.job.mail.password=asdfzxcv
[email protected]
xxl.job.mail.sendNick=《任務調度平臺XXL-JOB》

### 登錄賬號

xxl.job.login.username=admin
xxl.job.login.password=123456

### 調度中心通訊TOKEN，非空時啟用

xxl.job.accessToken=

步驟二：部署項目：

如果已經正確進行上述配置，可將項目編譯打war包並部署到tomcat中。調度中心訪問地址：http://localhost:8080/xxl-job-admin (該地址執行器將會使用到，作為回調地址)，登錄後運行界面如下圖所示

至此“調度中心”項目已經部署成功。

步驟三：調度中心集群（可選）：

調度中心支持集群部署，提升調度系統可用性。

集群部署唯一要求為：保證每個集群節點配置（db和登陸賬號等）保持一致。調度中心通過db配置區分不同集群。

調度中心在集群部署時可通過nginx負載均衡，此時可以為集群分配一個域名。該域名一方面可以用於訪問，另一方面也可以用於配置執行器回調地址。

2.4 配置部署“執行器項目”

“執行器”項目：xxl-job-executor-sample-spring (如新建執行器項目，可參考該Sample示例執行器項目的配置步驟；)

作用：負責接收“調度中心”的調度並執行；可直接部署執行器，也可以將執行器集成到現有業務項目中。

步驟一：maven依賴確認pom文件中引入瞭 "xxl-job-core" 的maven依賴；

步驟二：執行器配置執行器配置，配置文件地址：

/xxl-job/xxl-job-executor-samples/xxl-job-executor-sample-spring/src/main/resources/xxl-job-executor.properties

執行器配置，配置內容說明：

### xxl-job admin address list：調度中心部署跟地址：如調度中心集群部署存在多個地址則用逗號分隔。執行器將會使用該地址進行"執行器心跳註冊"和"任務結果回調"。

xxl.job.admin.addresses=http://127.0.0.1:8080/xxl-job-admin

### xxl-job executor address：執行器"AppName"和地址信息配置：AppName執行器心跳註冊分組依據；地址信息用於"調度中心請求並觸發任務"和"執行器註冊"。執行器默認端口為9999，執行器IP默認為空表示自動獲取IP，多網卡時可手動設置指定IP，手動設置IP時將會綁定Host。單機部署多個執行器時，註意要配置不同執行器端口；

xxl.job.executor.appname=xxl-job-executor-sample
xxl.job.executor.ip=
xxl.job.executor.port=9999

### xxl-job log path：執行器運行日志文件存儲的磁盤位置，需要對該路徑擁有讀寫權限
xxl.job.executor.logpath=/data/applogs/xxl-job/jobhandler/

### xxl-job, access token：執行器通訊TOKEN，非空時啟用

xxl.job.accessToken=

步驟三：執行器組件配置執行器組件，配置文件地址：

/xxl-job/xxl-job-executor-samples/xxl-job-executor-sample-spring/src/main/resources/applicationcontext-xxl-job.xml

執行器組件，配置內容說明：

<!-- 配置01、JobHandler 掃描路徑：自動掃描容器中JobHandler -->
<context:component-scan base-package="com.xxl.job.executor.service.jobhandler" />

<!-- 配置02、執行器Excutor配置：執行器核心配置 -->
<bean id="xxlJobExecutor" class="com.xxl.job.core.executor.XxlJobExecutor" init-method="start" destroy-method="destroy" >
    <!-- 執行器IP[選填]，為空則自動獲取 -->
    <property name="ip" value="${xxl.job.executor.ip}" />
    <!-- 執行器端口號[必須] -->
    <property name="port" value="${xxl.job.executor.port}" />
    <!-- 執行器AppName[選填]，為空則關閉自動註冊 -->
    <property name="appName" value="${xxl.job.executor.appname}" />
    <!-- 執行器註冊中心地址[選填]，為空則關閉自動註冊 -->
    <property name="adminAddresses" value="${xxl.job.admin.addresses}" />
    <!-- 執行器日志路徑[必填] -->
    <property name="logPath" value="${xxl.job.executor.logpath}" />
    <!-- 訪問令牌，非空則進行匹配校驗[選填] -->
    <property name="accessToken" value="${xxl.job.accessToken}" />
</bean>

步驟四：部署執行器項目：如果已經正確進行上述配置，可將執行器項目編譯打部署，系統提供三個執行器Sample示例項目，選擇其中一個即可，各自的部署方式如下。

xxl-job-executor-sample-spring：項目編譯打包成WAR包，並部署到tomcat中。
xxl-job-executor-sample-springboot：項目編譯打包成springboot類型的可執行JAR包，命令啟動即可；

至此“執行器”項目已經部署結束。

步驟五：執行器集群（可選）：

執行器支持集群部署，提升調度系統可用性，同時提升任務處理能力。

集群部署唯一要求為：保證集群中每個執行器的配置項 "xxl.job.admin.addresses/調度中心地址" 保持一致，執行器根據該配置進行執行器自動註冊等操作。

2.5 開發第一個任務“Hello World”

本示例以新建一個 “GLUE模式(Java)” 運行模式的任務為例。更多有關任務的詳細配置，請查看“章節三：任務詳解”。（ “GLUE模式(Java)”的執行代碼托管到調度中心在線維護，相比“Bean模式任務”需要在執行器項目開發部署上線，更加簡便輕量）

前提：請確認“調度中心”和“執行器”項目已經成功部署並啟動；

步驟一：新建任務：登錄調度中心，點擊下圖所示“新建任務”按鈕，新建示例任務。然後，參考下面截圖中任務的參數配置，點擊保存。

步驟二：“GLUE模式(Java)” 任務開發：

請點擊任務右側 “GLUE” 按鈕，進入 “GLUE編輯器開發界面” ，見下圖。“GLUE模式(Java)” 運行模式的任務默認已經初始化瞭示例任務代碼，即打印Hello World。（ “GLUE模式(Java)” 運行模式的任務實際上是一段繼承自IJobHandler的Java類代碼，它在執行器項目中運行，可使用@Resource/@Autowire註入執行器裡中的其他服務）

步驟三：觸發執行：請點擊任務右側 “執行” 按鈕，可手動觸發一次任務執行（通常情況下，通過配置Cron表達式進行任務調度出發）。

步驟四：查看日志：請點擊任務右側 “日志” 按鈕，可前往任務日志界面查看任務日志。在任務日志界面中，可查看該任務的歷史調度記錄以及每一次調度的任務調度信息、執行參數和執行信息。運行中的任務點擊右側的“執行日志”按鈕，可進入日志控制臺查看實時執行日志。

以上內容節選項目手冊：http://www.xuxueli.com/xxl-job/

以上就是分佈式任務調度xxl-job問題解決的詳細內容，更多關於分佈式任務調度xxl-job的資料請關註WalkonNet其它相關文章！

分佈式任務調度xxl-job問題解決

目錄

前言

xxl-job簡介

功能如下