浏览代码

升级正式版本:1.8.1

xuxueli 8 年前
父节点
当前提交
27446880df

+ 2 - 2
README.md 查看文件

109
 [http://git.oschina.net/xuxueli0323/xxl-job](http://git.oschina.net/xuxueli0323/xxl-job) | [Download](http://git.oschina.net/xuxueli0323/xxl-job/releases)
109
 [http://git.oschina.net/xuxueli0323/xxl-job](http://git.oschina.net/xuxueli0323/xxl-job) | [Download](http://git.oschina.net/xuxueli0323/xxl-job/releases)
110
 
110
 
111
 
111
 
112
-#### 中央仓库地址 (最新Release版本:1.8.0)
112
+#### 中央仓库地址 (最新Release版本:1.8.1)
113
 
113
 
114
 ```
114
 ```
115
 <!-- http://repo1.maven.org/maven2/com/xuxueli/xxl-job-core/ -->
115
 <!-- http://repo1.maven.org/maven2/com/xuxueli/xxl-job-core/ -->
116
 <dependency>
116
 <dependency>
117
     <groupId>com.xuxueli</groupId>
117
     <groupId>com.xuxueli</groupId>
118
     <artifactId>xxl-job-core</artifactId>
118
     <artifactId>xxl-job-core</artifactId>
119
-    <version>1.8.0</version>
119
+    <version>1.8.1</version>
120
 </dependency>
120
 </dependency>
121
 ```
121
 ```
122
 
122
 

+ 38 - 17
doc/XXL-JOB官方文档.md 查看文件

100
 [http://git.oschina.net/xuxueli0323/xxl-job](http://git.oschina.net/xuxueli0323/xxl-job) | [Download](http://git.oschina.net/xuxueli0323/xxl-job/releases)
100
 [http://git.oschina.net/xuxueli0323/xxl-job](http://git.oschina.net/xuxueli0323/xxl-job) | [Download](http://git.oschina.net/xuxueli0323/xxl-job/releases)
101
 
101
 
102
 
102
 
103
-#### 中央仓库地址 (最新Release版本:1.8.0)
103
+#### 中央仓库地址 (最新Release版本:1.8.1)
104
 
104
 
105
 ```
105
 ```
106
 <!-- http://repo1.maven.org/maven2/com/xuxueli/xxl-job-core/ -->
106
 <!-- http://repo1.maven.org/maven2/com/xuxueli/xxl-job-core/ -->
107
 <dependency>
107
 <dependency>
108
     <groupId>com.xuxueli</groupId>
108
     <groupId>com.xuxueli</groupId>
109
     <artifactId>xxl-job-core</artifactId>
109
     <artifactId>xxl-job-core</artifactId>
110
-    <version>1.8.0</version>
110
+    <version>1.8.1</version>
111
 </dependency>
111
 </dependency>
112
 ```
112
 ```
113
 
113
 
127
 ### 1.5 环境
127
 ### 1.5 环境
128
 - JDK:1.7+
128
 - JDK:1.7+
129
 - Servlet/JSP Spec:3.1/2.3
129
 - Servlet/JSP Spec:3.1/2.3
130
-- Tomcat:8.5.x/Jetty9.2
131
-- Spring-boot:1.3.8/Spring4.x
130
+- Tomcat:8.5.x/Jetty9.2.x
131
+- Spring-boot:1.5.x/Spring4.x
132
 - Mysql:5.6+
132
 - Mysql:5.6+
133
 - Maven:3+
133
 - Maven:3+
134
 
134
 
136
 ## 二、快速入门
136
 ## 二、快速入门
137
 
137
 
138
 ### 2.1 初始化“调度数据库”
138
 ### 2.1 初始化“调度数据库”
139
-请下载项目源码并解压,获取 "调度数据库初始化SQL脚本" 并执行即可。正常情况下应该生成16张表,脚本文件位置为:
139
+请下载项目源码并解压,获取 "调度数据库初始化SQL脚本" 并执行即可,正常情况下应该生成16张表。
140
 
140
 
141
-    源码解压根目录\xxl-job\db\tables_xxl_job.sql
141
+"调度数据库初始化SQL脚本" 位置为:
142
+
143
+    /xxl-job/db/tables_xxl_job.sql
142
 
144
 
143
 调度中心支持集群部署,集群情况下各节点务必连接同一个mysql实例;
145
 调度中心支持集群部署,集群情况下各节点务必连接同一个mysql实例;
144
 
146
 
145
 如果mysql做主从,调度中心集群节点务必强制走主库;
147
 如果mysql做主从,调度中心集群节点务必强制走主库;
146
 
148
 
147
 ### 2.2 编译源码
149
 ### 2.2 编译源码
148
-解压源码,按照maven格式将源码导入IDE, 使用maven进行编译即可,源码结构如下图所示:
149
-
150
-![输入图片说明](https://static.oschina.net/uploads/img/201705/11214348_aGgr.png "在这里输入图片标题")
150
+解压源码,按照maven格式将源码导入IDE, 使用maven进行编译即可,源码结构如下:
151
 
151
 
152
     xxl-job-admin:调度中心
152
     xxl-job-admin:调度中心
153
     xxl-job-core:公共依赖
153
     xxl-job-core:公共依赖
160
     作用:统一管理任务调度平台上调度任务,负责触发调度执行。
160
     作用:统一管理任务调度平台上调度任务,负责触发调度执行。
161
 
161
 
162
 #### 步骤一:调度中心配置:
162
 #### 步骤一:调度中心配置:
163
-配置文件以及配置属性如下图所示。
163
+调度中心配置文件地址:
164
+
165
+    /xxl-job/xxl-job-admin/src/main/resources/xxl-job-admin.properties
164
 
166
 
165
-![输入图片说明](https://static.oschina.net/uploads/img/201705/11214752_Ifvp.png "在这里输入图片标题")
166
 
167
 
168
+调度中心配置内容说明:
167
 
169
 
168
     ### 调度中心JDBC链接:链接地址请保持和 2.1章节 所创建的调度数据库的地址一致
170
     ### 调度中心JDBC链接:链接地址请保持和 2.1章节 所创建的调度数据库的地址一致
169
     xxl.job.db.driverClass=com.mysql.jdbc.Driver
171
     xxl.job.db.driverClass=com.mysql.jdbc.Driver
170
-    xxl.job.db.url=jdbc:mysql://localhost:3306/xxl-job?useUnicode=true&amp;characterEncoding=UTF-8
172
+    xxl.job.db.url=jdbc:mysql://localhost:3306/xxl-job?useUnicode=true&characterEncoding=UTF-8
171
     xxl.job.db.user=root
173
     xxl.job.db.user=root
172
     xxl.job.db.password=root_pwd
174
     xxl.job.db.password=root_pwd
173
     
175
     
179
     xxl.job.mail.sendFrom=ovono802302@163.com
181
     xxl.job.mail.sendFrom=ovono802302@163.com
180
     xxl.job.mail.sendNick=《任务调度平台XXL-JOB》
182
     xxl.job.mail.sendNick=《任务调度平台XXL-JOB》
181
     
183
     
182
-    # 登录账号
184
+    ### 登录账号
183
     xxl.job.login.username=admin
185
     xxl.job.login.username=admin
184
     xxl.job.login.password=123456
186
     xxl.job.login.password=123456
187
+    
188
+    ### 调度中心通讯TOKEN,非空时启用
189
+    xxl.job.accessToken=
185
 
190
 
186
 #### 步骤二:部署项目:
191
 #### 步骤二:部署项目:
187
 如果已经正确进行上述配置,可将项目编译打war包并部署到tomcat中。
192
 如果已经正确进行上述配置,可将项目编译打war包并部署到tomcat中。
191
 
196
 
192
 至此“调度中心”项目已经部署成功。
197
 至此“调度中心”项目已经部署成功。
193
 
198
 
199
+#### 步骤三:调度中心集群(可选):
200
+调度中心支持集群部署,提升调度系统可用性。
201
+
202
+集群部署唯一要求为:保证每个集群节点配置(db和登陆账号等)保持一致。调度中心通过db配置区分不同集群。
203
+
204
+调度中心在集群部署时可通过nginx负载均衡,此时可以为集群分配一个域名。该域名一方面可以用于访问,另一方面也可以用于配置执行器回调地址。
205
+
194
 ### 2.4 配置部署“执行器项目”
206
 ### 2.4 配置部署“执行器项目”
195
 
207
 
196
     “执行器”项目:xxl-job-executor-example (如新建执行器项目,可参考该Example执行器项目的配置步骤;)
208
     “执行器”项目:xxl-job-executor-example (如新建执行器项目,可参考该Example执行器项目的配置步骤;)
200
 确认pom文件中引入了 "xxl-job-core" 的maven依赖;
212
 确认pom文件中引入了 "xxl-job-core" 的maven依赖;
201
     
213
     
202
 #### 步骤二:执行器配置
214
 #### 步骤二:执行器配置
203
-配置文件以及配置属性如下图所示。
215
+执行器配置配置文件地址:
204
 
216
 
205
-![输入图片说明](https://static.oschina.net/uploads/img/201705/11214800_7G3o.png "在这里输入图片标题")
217
+    /xxl-job/xxl-job-executor-example/src/main/resources/xxl-job-executor.properties
206
 
218
 
219
+执行器配置配置内容说明:
207
 
220
 
208
     ### xxl-job admin address list:调度中心部署跟地址:如调度中心集群部署存在多个地址则用逗号分隔。执行器将会使用该地址进行"执行器心跳注册"和"任务结果回调"。
221
     ### xxl-job admin address list:调度中心部署跟地址:如调度中心集群部署存在多个地址则用逗号分隔。执行器将会使用该地址进行"执行器心跳注册"和"任务结果回调"。
209
     xxl.job.admin.addresses=http://127.0.0.1:8080/xxl-job-admin
222
     xxl.job.admin.addresses=http://127.0.0.1:8080/xxl-job-admin
215
     
228
     
216
     ### xxl-job log path:执行器运行日志文件存储的磁盘位置
229
     ### xxl-job log path:执行器运行日志文件存储的磁盘位置
217
     xxl.job.executor.logpath=/data/applogs/xxl-job/jobhandler/
230
     xxl.job.executor.logpath=/data/applogs/xxl-job/jobhandler/
231
+    
232
+    ### xxl-job, access token:执行器通讯TOKEN,非空时启用
233
+    xxl.job.accessToken=
218
 
234
 
219
 
235
 
220
 #### 步骤三:执行器组件配置
236
 #### 步骤三:执行器组件配置
225
     1、JobHandler 扫描路径:自动扫描容器中JobHandler;
241
     1、JobHandler 扫描路径:自动扫描容器中JobHandler;
226
     2、执行器Excutor配置:执行器核心配置;
242
     2、执行器Excutor配置:执行器核心配置;
227
 
243
 
228
-#### 步骤四:部署项目:
244
+#### 步骤四:部署执行器项目:
229
 如果已经正确进行上述配置,可将执行器项目编译打部署,系统提供两个执行器example项目,选择其中一个即可,各自的部署方式如下。
245
 如果已经正确进行上述配置,可将执行器项目编译打部署,系统提供两个执行器example项目,选择其中一个即可,各自的部署方式如下。
230
 
246
 
231
     xxl-job-executor-example:项目编译打包成WAR包,并部署到tomcat中。
247
     xxl-job-executor-example:项目编译打包成WAR包,并部署到tomcat中。
233
 
249
 
234
 至此“执行器”项目已经部署结束。
250
 至此“执行器”项目已经部署结束。
235
 
251
 
252
+#### 步骤五:执行器集群(可选):
253
+执行器支持集群部署,提升调度系统可用性,同时提升任务处理能力。
254
+
255
+集群部署唯一要求为:保证集群中每个执行器的配置项 "xxl.job.admin.addresses/调度中心地址" 保持一致,执行器根据该配置进行执行器自动注册等操作。 
256
+
236
 
257
 
237
 ### 2.5 开发第一个任务“Hello World”       
258
 ### 2.5 开发第一个任务“Hello World”       
238
 本示例以新建一个 “GLUE模式(Java)” 运行模式的任务为例。更多有关任务的详细配置,请查看“章节三:任务详解”。
259
 本示例以新建一个 “GLUE模式(Java)” 运行模式的任务为例。更多有关任务的详细配置,请查看“章节三:任务详解”。
896
 - 10、执行日志,支持根据运行 "状态" 筛选日志;
917
 - 10、执行日志,支持根据运行 "状态" 筛选日志;
897
 - 11、调度中心任务注册检测逻辑优化;
918
 - 11、调度中心任务注册检测逻辑优化;
898
 
919
 
899
-#### 6.18 版本 V1.8.1 特性[快照版本]
920
+#### 6.18 版本 V1.8.1 特性[2017-07-30]
900
 - 1、分片广播任务:执行器集群部署时,任务路由策略选择"分片广播"情况下,一次任务调度将会广播触发集群中所有执行器执行一次任务,可根据分片参数处理分片任务;
921
 - 1、分片广播任务:执行器集群部署时,任务路由策略选择"分片广播"情况下,一次任务调度将会广播触发集群中所有执行器执行一次任务,可根据分片参数处理分片任务;
901
 - 2、动态分片:分片广播任务以执行器为维度进行分片,支持动态扩容执行器集群从而动态增加分片数量,协同进行业务处理;在进行大数据量业务操作时可显著提升任务处理能力和速度。
922
 - 2、动态分片:分片广播任务以执行器为维度进行分片,支持动态扩容执行器集群从而动态增加分片数量,协同进行业务处理;在进行大数据量业务操作时可显著提升任务处理能力和速度。
902
 - 3、执行器JobHandler禁止命名冲突;
923
 - 3、执行器JobHandler禁止命名冲突;

+ 1 - 1
pom.xml 查看文件

3
 	<modelVersion>4.0.0</modelVersion>
3
 	<modelVersion>4.0.0</modelVersion>
4
 	<groupId>com.xuxueli</groupId>
4
 	<groupId>com.xuxueli</groupId>
5
 	<artifactId>xxl-job</artifactId>
5
 	<artifactId>xxl-job</artifactId>
6
-	<version>1.8.1-SNAPSHOT</version>
6
+	<version>1.8.1</version>
7
 	<packaging>pom</packaging>
7
 	<packaging>pom</packaging>
8
 
8
 
9
 	<name>${project.artifactId}</name>
9
 	<name>${project.artifactId}</name>

+ 1 - 1
xxl-job-admin/pom.xml 查看文件

4
 	<parent>
4
 	<parent>
5
 		<groupId>com.xuxueli</groupId>
5
 		<groupId>com.xuxueli</groupId>
6
 		<artifactId>xxl-job</artifactId>
6
 		<artifactId>xxl-job</artifactId>
7
-		<version>1.8.1-SNAPSHOT</version>
7
+		<version>1.8.1</version>
8
 	</parent>
8
 	</parent>
9
 	<artifactId>xxl-job-admin</artifactId>
9
 	<artifactId>xxl-job-admin</artifactId>
10
 	<packaging>war</packaging>
10
 	<packaging>war</packaging>

+ 2 - 2
xxl-job-admin/src/main/resources/xxl-job-admin.properties 查看文件

12
 xxl.job.mail.sendFrom=ovono802302@163.com
12
 xxl.job.mail.sendFrom=ovono802302@163.com
13
 xxl.job.mail.sendNick=《任务调度平台XXL-JOB》
13
 xxl.job.mail.sendNick=《任务调度平台XXL-JOB》
14
 
14
 
15
-# xxl-job login
15
+### xxl-job login
16
 xxl.job.login.username=admin
16
 xxl.job.login.username=admin
17
 xxl.job.login.password=123456
17
 xxl.job.login.password=123456
18
 
18
 
19
-# xxl-job, access token
19
+### xxl-job, access token
20
 xxl.job.accessToken=
20
 xxl.job.accessToken=

+ 1 - 1
xxl-job-admin/src/main/webapp/WEB-INF/template/common/common.macro.ftl 查看文件

175
 
175
 
176
 <#macro commonFooter >
176
 <#macro commonFooter >
177
 	<footer class="main-footer">
177
 	<footer class="main-footer">
178
-        Powered by <b>XXL-JOB</b> 1.8.1(快照版)
178
+        Powered by <b>XXL-JOB</b> 1.8.1
179
 		<div class="pull-right hidden-xs">
179
 		<div class="pull-right hidden-xs">
180
             <strong>Copyright &copy; 2015-${.now?string('yyyy')} &nbsp;
180
             <strong>Copyright &copy; 2015-${.now?string('yyyy')} &nbsp;
181
                 <a href="https://github.com/xuxueli/xxl-job" target="_blank" >github</a>&nbsp;
181
                 <a href="https://github.com/xuxueli/xxl-job" target="_blank" >github</a>&nbsp;

+ 1 - 1
xxl-job-core/pom.xml 查看文件

4
 	<parent>
4
 	<parent>
5
 		<groupId>com.xuxueli</groupId>
5
 		<groupId>com.xuxueli</groupId>
6
 		<artifactId>xxl-job</artifactId>
6
 		<artifactId>xxl-job</artifactId>
7
-		<version>1.8.1-SNAPSHOT</version>
7
+		<version>1.8.1</version>
8
 	</parent>
8
 	</parent>
9
 	<artifactId>xxl-job-core</artifactId>
9
 	<artifactId>xxl-job-core</artifactId>
10
 	<packaging>jar</packaging>
10
 	<packaging>jar</packaging>

+ 1 - 1
xxl-job-executor-example/pom.xml 查看文件

4
 	<parent>
4
 	<parent>
5
 		<groupId>com.xuxueli</groupId>
5
 		<groupId>com.xuxueli</groupId>
6
 		<artifactId>xxl-job</artifactId>
6
 		<artifactId>xxl-job</artifactId>
7
-		<version>1.8.1-SNAPSHOT</version>
7
+		<version>1.8.1</version>
8
 	</parent>
8
 	</parent>
9
 	<artifactId>xxl-job-executor-example</artifactId>
9
 	<artifactId>xxl-job-executor-example</artifactId>
10
 	<packaging>war</packaging>
10
 	<packaging>war</packaging>

+ 1 - 1
xxl-job-executor-springboot-example/pom.xml 查看文件

6
     <parent>
6
     <parent>
7
         <groupId>com.xuxueli</groupId>
7
         <groupId>com.xuxueli</groupId>
8
         <artifactId>xxl-job</artifactId>
8
         <artifactId>xxl-job</artifactId>
9
-        <version>1.8.1-SNAPSHOT</version>
9
+        <version>1.8.1</version>
10
     </parent>
10
     </parent>
11
     <artifactId>xxl-job-executor-springboot-example</artifactId>
11
     <artifactId>xxl-job-executor-springboot-example</artifactId>
12
     <packaging>jar</packaging>
12
     <packaging>jar</packaging>