From 27446880df9386c3a7cdbfcc9dd37ebd375d763d Mon Sep 17 00:00:00 2001 From: xuxueli <931591021@qq.com> Date: Sun, 30 Jul 2017 19:37:40 +0800 Subject: [PATCH] =?UTF-8?q?=E5=8D=87=E7=BA=A7=E6=AD=A3=E5=BC=8F=E7=89=88?= =?UTF-8?q?=E6=9C=AC=EF=BC=9A1.8.1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 4 +- doc/XXL-JOB官方文档.md | 55 +++++++++++++------ pom.xml | 2 +- xxl-job-admin/pom.xml | 2 +- .../main/resources/xxl-job-admin.properties | 4 +- .../WEB-INF/template/common/common.macro.ftl | 2 +- xxl-job-core/pom.xml | 2 +- xxl-job-executor-example/pom.xml | 2 +- xxl-job-executor-springboot-example/pom.xml | 2 +- 9 files changed, 48 insertions(+), 27 deletions(-) diff --git a/README.md b/README.md index 2439e46e..d68e8542 100644 --- a/README.md +++ b/README.md @@ -109,14 +109,14 @@ XXL-JOB是一个轻量级分布式任务调度框架，其核心设计目标是 [http://git.oschina.net/xuxueli0323/xxl-job](http://git.oschina.net/xuxueli0323/xxl-job) | [Download](http://git.oschina.net/xuxueli0323/xxl-job/releases) -#### 中央仓库地址 (最新Release版本：1.8.0) +#### 中央仓库地址 (最新Release版本：1.8.1) ``` com.xuxueli xxl-job-core - 1.8.0 + 1.8.1 ``` diff --git a/doc/XXL-JOB官方文档.md b/doc/XXL-JOB官方文档.md index fcce9d80..aa6579a8 100644 --- a/doc/XXL-JOB官方文档.md +++ b/doc/XXL-JOB官方文档.md @@ -100,14 +100,14 @@ XXL-JOB是一个轻量级分布式任务调度框架，其核心设计目标是 [http://git.oschina.net/xuxueli0323/xxl-job](http://git.oschina.net/xuxueli0323/xxl-job) | [Download](http://git.oschina.net/xuxueli0323/xxl-job/releases) -#### 中央仓库地址 (最新Release版本：1.8.0) +#### 中央仓库地址 (最新Release版本：1.8.1) ``` com.xuxueli xxl-job-core - 1.8.0 + 1.8.1 ``` @@ -127,8 +127,8 @@ XXL-JOB是一个轻量级分布式任务调度框架，其核心设计目标是 ### 1.5 环境 - JDK：1.7+ - Servlet/JSP Spec：3.1/2.3 -- Tomcat：8.5.x/Jetty9.2 -- Spring-boot：1.3.8/Spring4.x +- Tomcat：8.5.x/Jetty9.2.x +- Spring-boot：1.5.x/Spring4.x - Mysql：5.6+ - Maven：3+ @@ -136,18 +136,18 @@ XXL-JOB是一个轻量级分布式任务调度框架，其核心设计目标是 ## 二、快速入门 ### 2.1 初始化“调度数据库” -请下载项目源码并解压，获取 "调度数据库初始化SQL脚本" 并执行即可。正常情况下应该生成16张表，脚本文件位置为: +请下载项目源码并解压，获取 "调度数据库初始化SQL脚本" 并执行即可，正常情况下应该生成16张表。 - 源码解压根目录\xxl-job\db\tables_xxl_job.sql +"调度数据库初始化SQL脚本" 位置为: + + /xxl-job/db/tables_xxl_job.sql 调度中心支持集群部署，集群情况下各节点务必连接同一个mysql实例; 如果mysql做主从,调度中心集群节点务必强制走主库; ### 2.2 编译源码 -解压源码,按照maven格式将源码导入IDE, 使用maven进行编译即可，源码结构如下图所示： - -![输入图片说明](https://static.oschina.net/uploads/img/201705/11214348_aGgr.png "在这里输入图片标题") +解压源码,按照maven格式将源码导入IDE, 使用maven进行编译即可，源码结构如下： xxl-job-admin：调度中心 xxl-job-core：公共依赖 @@ -160,14 +160,16 @@ XXL-JOB是一个轻量级分布式任务调度框架，其核心设计目标是 作用：统一管理任务调度平台上调度任务，负责触发调度执行。 #### 步骤一：调度中心配置： -配置文件以及配置属性如下图所示。 +调度中心配置文件地址： + + /xxl-job/xxl-job-admin/src/main/resources/xxl-job-admin.properties -![输入图片说明](https://static.oschina.net/uploads/img/201705/11214752_Ifvp.png "在这里输入图片标题") +调度中心配置内容说明： ### 调度中心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.url=jdbc:mysql://localhost:3306/xxl-job?useUnicode=true&characterEncoding=UTF-8 xxl.job.db.user=root xxl.job.db.password=root_pwd @@ -179,9 +181,12 @@ XXL-JOB是一个轻量级分布式任务调度框架，其核心设计目标是 xxl.job.mail.sendFrom=ovono802302@163.com xxl.job.mail.sendNick=《任务调度平台XXL-JOB》 - # 登录账号 + ### 登录账号 xxl.job.login.username=admin xxl.job.login.password=123456 + + ### 调度中心通讯TOKEN，非空时启用 + xxl.job.accessToken= #### 步骤二：部署项目： 如果已经正确进行上述配置，可将项目编译打war包并部署到tomcat中。 @@ -191,6 +196,13 @@ XXL-JOB是一个轻量级分布式任务调度框架，其核心设计目标是 至此“调度中心”项目已经部署成功。 +#### 步骤三：调度中心集群（可选）： +调度中心支持集群部署，提升调度系统可用性。 + +集群部署唯一要求为：保证每个集群节点配置（db和登陆账号等）保持一致。调度中心通过db配置区分不同集群。 + +调度中心在集群部署时可通过nginx负载均衡，此时可以为集群分配一个域名。该域名一方面可以用于访问，另一方面也可以用于配置执行器回调地址。 + ### 2.4 配置部署“执行器项目” “执行器”项目：xxl-job-executor-example (如新建执行器项目，可参考该Example执行器项目的配置步骤；) @@ -200,10 +212,11 @@ XXL-JOB是一个轻量级分布式任务调度框架，其核心设计目标是 确认pom文件中引入了 "xxl-job-core" 的maven依赖； #### 步骤二：执行器配置 -配置文件以及配置属性如下图所示。 +执行器配置配置文件地址： -![输入图片说明](https://static.oschina.net/uploads/img/201705/11214800_7G3o.png "在这里输入图片标题") + /xxl-job/xxl-job-executor-example/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 @@ -215,6 +228,9 @@ XXL-JOB是一个轻量级分布式任务调度框架，其核心设计目标是 ### xxl-job log path：执行器运行日志文件存储的磁盘位置 xxl.job.executor.logpath=/data/applogs/xxl-job/jobhandler/ + + ### xxl-job, access token：执行器通讯TOKEN，非空时启用 + xxl.job.accessToken= #### 步骤三：执行器组件配置 @@ -225,7 +241,7 @@ XXL-JOB是一个轻量级分布式任务调度框架，其核心设计目标是 1、JobHandler 扫描路径：自动扫描容器中JobHandler； 2、执行器Excutor配置：执行器核心配置； -#### 步骤四：部署项目： +#### 步骤四：部署执行器项目： 如果已经正确进行上述配置，可将执行器项目编译打部署，系统提供两个执行器example项目，选择其中一个即可，各自的部署方式如下。 xxl-job-executor-example：项目编译打包成WAR包，并部署到tomcat中。 @@ -233,6 +249,11 @@ XXL-JOB是一个轻量级分布式任务调度框架，其核心设计目标是 至此“执行器”项目已经部署结束。 +#### 步骤五：执行器集群（可选）： +执行器支持集群部署，提升调度系统可用性，同时提升任务处理能力。 + +集群部署唯一要求为：保证集群中每个执行器的配置项 "xxl.job.admin.addresses/调度中心地址" 保持一致，执行器根据该配置进行执行器自动注册等操作。 + ### 2.5 开发第一个任务“Hello World” 本示例以新建一个 “GLUE模式(Java)” 运行模式的任务为例。更多有关任务的详细配置，请查看“章节三：任务详解”。 @@ -896,7 +917,7 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段 - 10、执行日志，支持根据运行 "状态" 筛选日志； - 11、调度中心任务注册检测逻辑优化； -#### 6.18 版本 V1.8.1 特性[快照版本] +#### 6.18 版本 V1.8.1 特性[2017-07-30] - 1、分片广播任务：执行器集群部署时，任务路由策略选择"分片广播"情况下，一次任务调度将会广播触发集群中所有执行器执行一次任务，可根据分片参数处理分片任务； - 2、动态分片：分片广播任务以执行器为维度进行分片，支持动态扩容执行器集群从而动态增加分片数量，协同进行业务处理；在进行大数据量业务操作时可显著提升任务处理能力和速度。 - 3、执行器JobHandler禁止命名冲突； diff --git a/pom.xml b/pom.xml index 94172618..ed6fd07a 100644 --- a/pom.xml +++ b/pom.xml @@ -3,7 +3,7 @@ 4.0.0 com.xuxueli xxl-job - 1.8.1-SNAPSHOT + 1.8.1 pom ${project.artifactId} diff --git a/xxl-job-admin/pom.xml b/xxl-job-admin/pom.xml index 1d4b63b1..d3d719b5 100644 --- a/xxl-job-admin/pom.xml +++ b/xxl-job-admin/pom.xml @@ -4,7 +4,7 @@ com.xuxueli xxl-job - 1.8.1-SNAPSHOT + 1.8.1 xxl-job-admin war diff --git a/xxl-job-admin/src/main/resources/xxl-job-admin.properties b/xxl-job-admin/src/main/resources/xxl-job-admin.properties index b00ef4b2..ac5576f7 100644 --- a/xxl-job-admin/src/main/resources/xxl-job-admin.properties +++ b/xxl-job-admin/src/main/resources/xxl-job-admin.properties @@ -12,9 +12,9 @@ xxl.job.mail.password=asdfzxcv xxl.job.mail.sendFrom=ovono802302@163.com xxl.job.mail.sendNick=《任务调度平台XXL-JOB》 -# xxl-job login +### xxl-job login xxl.job.login.username=admin xxl.job.login.password=123456 -# xxl-job, access token +### xxl-job, access token xxl.job.accessToken= \ No newline at end of file diff --git a/xxl-job-admin/src/main/webapp/WEB-INF/template/common/common.macro.ftl b/xxl-job-admin/src/main/webapp/WEB-INF/template/common/common.macro.ftl index 9df01bda..1d4a9bb3 100644 --- a/xxl-job-admin/src/main/webapp/WEB-INF/template/common/common.macro.ftl +++ b/xxl-job-admin/src/main/webapp/WEB-INF/template/common/common.macro.ftl @@ -175,7 +175,7 @@ <#macro commonFooter >