瀏覽代碼

升级正式版本:1.8.1

xuxueli 8 年之前
父節點
當前提交
27446880df

+ 2 - 2
README.md 查看文件

@@ -109,14 +109,14 @@ XXL-JOB是一个轻量级分布式任务调度框架,其核心设计目标是
109 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 115
 <!-- http://repo1.maven.org/maven2/com/xuxueli/xxl-job-core/ -->
116 116
 <dependency>
117 117
     <groupId>com.xuxueli</groupId>
118 118
     <artifactId>xxl-job-core</artifactId>
119
-    <version>1.8.0</version>
119
+    <version>1.8.1</version>
120 120
 </dependency>
121 121
 ```
122 122
 

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

@@ -100,14 +100,14 @@ XXL-JOB是一个轻量级分布式任务调度框架,其核心设计目标是
100 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 106
 <!-- http://repo1.maven.org/maven2/com/xuxueli/xxl-job-core/ -->
107 107
 <dependency>
108 108
     <groupId>com.xuxueli</groupId>
109 109
     <artifactId>xxl-job-core</artifactId>
110
-    <version>1.8.0</version>
110
+    <version>1.8.1</version>
111 111
 </dependency>
112 112
 ```
113 113
 
@@ -127,8 +127,8 @@ XXL-JOB是一个轻量级分布式任务调度框架,其核心设计目标是
127 127
 ### 1.5 环境
128 128
 - JDK:1.7+
129 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 132
 - Mysql:5.6+
133 133
 - Maven:3+
134 134
 
@@ -136,18 +136,18 @@ XXL-JOB是一个轻量级分布式任务调度框架,其核心设计目标是
136 136
 ## 二、快速入门
137 137
 
138 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 145
 调度中心支持集群部署,集群情况下各节点务必连接同一个mysql实例;
144 146
 
145 147
 如果mysql做主从,调度中心集群节点务必强制走主库;
146 148
 
147 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 152
     xxl-job-admin:调度中心
153 153
     xxl-job-core:公共依赖
@@ -160,14 +160,16 @@ XXL-JOB是一个轻量级分布式任务调度框架,其核心设计目标是
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 170
     ### 调度中心JDBC链接:链接地址请保持和 2.1章节 所创建的调度数据库的地址一致
169 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 173
     xxl.job.db.user=root
172 174
     xxl.job.db.password=root_pwd
173 175
     
@@ -179,9 +181,12 @@ XXL-JOB是一个轻量级分布式任务调度框架,其核心设计目标是
179 181
     xxl.job.mail.sendFrom=ovono802302@163.com
180 182
     xxl.job.mail.sendNick=《任务调度平台XXL-JOB》
181 183
     
182
-    # 登录账号
184
+    ### 登录账号
183 185
     xxl.job.login.username=admin
184 186
     xxl.job.login.password=123456
187
+    
188
+    ### 调度中心通讯TOKEN,非空时启用
189
+    xxl.job.accessToken=
185 190
 
186 191
 #### 步骤二:部署项目:
187 192
 如果已经正确进行上述配置,可将项目编译打war包并部署到tomcat中。
@@ -191,6 +196,13 @@ XXL-JOB是一个轻量级分布式任务调度框架,其核心设计目标是
191 196
 
192 197
 至此“调度中心”项目已经部署成功。
193 198
 
199
+#### 步骤三:调度中心集群(可选):
200
+调度中心支持集群部署,提升调度系统可用性。
201
+
202
+集群部署唯一要求为:保证每个集群节点配置(db和登陆账号等)保持一致。调度中心通过db配置区分不同集群。
203
+
204
+调度中心在集群部署时可通过nginx负载均衡,此时可以为集群分配一个域名。该域名一方面可以用于访问,另一方面也可以用于配置执行器回调地址。
205
+
194 206
 ### 2.4 配置部署“执行器项目”
195 207
 
196 208
     “执行器”项目:xxl-job-executor-example (如新建执行器项目,可参考该Example执行器项目的配置步骤;)
@@ -200,10 +212,11 @@ XXL-JOB是一个轻量级分布式任务调度框架,其核心设计目标是
200 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 221
     ### xxl-job admin address list:调度中心部署跟地址:如调度中心集群部署存在多个地址则用逗号分隔。执行器将会使用该地址进行"执行器心跳注册"和"任务结果回调"。
209 222
     xxl.job.admin.addresses=http://127.0.0.1:8080/xxl-job-admin
@@ -215,6 +228,9 @@ XXL-JOB是一个轻量级分布式任务调度框架,其核心设计目标是
215 228
     
216 229
     ### xxl-job log path:执行器运行日志文件存储的磁盘位置
217 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,7 +241,7 @@ XXL-JOB是一个轻量级分布式任务调度框架,其核心设计目标是
225 241
     1、JobHandler 扫描路径:自动扫描容器中JobHandler;
226 242
     2、执行器Excutor配置:执行器核心配置;
227 243
 
228
-#### 步骤四:部署项目:
244
+#### 步骤四:部署执行器项目:
229 245
 如果已经正确进行上述配置,可将执行器项目编译打部署,系统提供两个执行器example项目,选择其中一个即可,各自的部署方式如下。
230 246
 
231 247
     xxl-job-executor-example:项目编译打包成WAR包,并部署到tomcat中。
@@ -233,6 +249,11 @@ XXL-JOB是一个轻量级分布式任务调度框架,其核心设计目标是
233 249
 
234 250
 至此“执行器”项目已经部署结束。
235 251
 
252
+#### 步骤五:执行器集群(可选):
253
+执行器支持集群部署,提升调度系统可用性,同时提升任务处理能力。
254
+
255
+集群部署唯一要求为:保证集群中每个执行器的配置项 "xxl.job.admin.addresses/调度中心地址" 保持一致,执行器根据该配置进行执行器自动注册等操作。 
256
+
236 257
 
237 258
 ### 2.5 开发第一个任务“Hello World”       
238 259
 本示例以新建一个 “GLUE模式(Java)” 运行模式的任务为例。更多有关任务的详细配置,请查看“章节三:任务详解”。
@@ -896,7 +917,7 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
896 917
 - 10、执行日志,支持根据运行 "状态" 筛选日志;
897 918
 - 11、调度中心任务注册检测逻辑优化;
898 919
 
899
-#### 6.18 版本 V1.8.1 特性[快照版本]
920
+#### 6.18 版本 V1.8.1 特性[2017-07-30]
900 921
 - 1、分片广播任务:执行器集群部署时,任务路由策略选择"分片广播"情况下,一次任务调度将会广播触发集群中所有执行器执行一次任务,可根据分片参数处理分片任务;
901 922
 - 2、动态分片:分片广播任务以执行器为维度进行分片,支持动态扩容执行器集群从而动态增加分片数量,协同进行业务处理;在进行大数据量业务操作时可显著提升任务处理能力和速度。
902 923
 - 3、执行器JobHandler禁止命名冲突;

+ 1 - 1
pom.xml 查看文件

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

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

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

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

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

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

@@ -175,7 +175,7 @@
175 175
 
176 176
 <#macro commonFooter >
177 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 179
 		<div class="pull-right hidden-xs">
180 180
             <strong>Copyright &copy; 2015-${.now?string('yyyy')} &nbsp;
181 181
                 <a href="https://github.com/xuxueli/xxl-job" target="_blank" >github</a>&nbsp;

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

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

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

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

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

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