Преглед изворни кода

Glue(Shell) 等脚本任务支持失败重试;

xuxueli пре 7 година
родитељ
комит
ea5b3541e4

+ 13 - 3
doc/XXL-JOB官方文档.md Прегледај датотеку

@@ -785,14 +785,15 @@ xxl-job-admin#com.xxl.job.admin.controller.JobApiController.callback
785 785
 
786 786
 #### 5.5.3 GLUE模式(Shell) + GLUE模式(Python) + GLUE模式(NodeJS)
787 787
 开发步骤:可参考 "章节三" ;
788
-原理:脚本任务的源码托管在调度中心,脚本逻辑在执行器运行。当触发脚本任务时,执行器会加载脚本源码在执行器机器上生成一份脚本文件,然后通过Java代码调用该脚本;并且实时将脚本输出日志写到任务日志文件中,从而在调度中心可以实时监控脚本运行情况;脚本返回码为0时表示执行成功,其他标示执行失败。
788
+原理:脚本任务的源码托管在调度中心,脚本逻辑在执行器运行。当触发脚本任务时,执行器会加载脚本源码在执行器机器上生成一份脚本文件,然后通过Java代码调用该脚本;并且实时将脚本输出日志写到任务日志文件中,从而在调度中心可以实时监控脚本运行情况;
789 789
 
790 790
 目前支持的脚本类型如下:
791 791
 
792 792
     - shell脚本:任务运行模式选择为 "GLUE模式(Shell)"时支持 "shell" 脚本任务;
793 793
     - python脚本:任务运行模式选择为 "GLUE模式(Python)"时支持 "python" 脚本任务;
794 794
     - nodejs脚本:务运行模式选择为 "GLUE模式(NodeJS)"时支持 "nodejs" 脚本任务;
795
-    
795
+
796
+脚本任务通过 Exit Code 判断任务执行结果,状态码可参考章节 "5.15 任务执行结果说明";
796 797
 
797 798
 #### 5.5.4 执行器
798 799
 执行器实际上是一个内嵌的Jetty服务器,默认端口9999(配置项:xxl.job.executor.port)。
@@ -917,6 +918,15 @@ echo "分片总数 total = $3"
917 918
 - 3、等待B组机器任务运行结束并编译上线;执行器注册地址替换为A组+B组;
918 919
 操作结束;
919 920
 
921
+### 5.15 任务执行结果说明
922
+系统根据以下标准判断任务执行结果,可参考之。
923
+
924
+-- | Bean/Glue(Java) | Glue(Shell) 等脚本任务
925
+--- | --- | ---
926
+成功 | IJobHandler.SUCCESS | 0
927
+失败 | IJobHandler.FAIL | -1(其他)
928
+失败重试 | IJobHandler.FAIL_RETRY | 501
929
+
920 930
 
921 931
 ## 六、版本更新日志
922 932
 ### 6.1 版本 V1.1.x,新特性[2015-12-05]
@@ -1181,7 +1191,7 @@ Tips: 历史版本(V1.3.x)目前已经Release至稳定版本, 进入维护阶段
1181 1191
 - 3、[迭代中]任务超时设置,超时任务主动终止;
1182 1192
 - 4、任务属性枚举 "任务模式、阻塞策略" 国际化优化;
1183 1193
 - 5、任务日志表状态字段类型优化;
1184
-- 6、[迭代中]脚本任务支持失败重试;
1194
+- 6、Glue(Shell) 等脚本任务支持失败重试;
1185 1195
 - 7、告警邮箱支持SSL配置;
1186 1196
 - 8、Window机器下File.separator不兼容问题修复;
1187 1197
 

+ 9 - 2
xxl-job-core/src/main/java/com/xxl/job/core/handler/impl/ScriptJobHandler.java Прегледај датотеку

@@ -63,8 +63,15 @@ public class ScriptJobHandler extends IJobHandler {
63 63
         // invoke
64 64
         XxlJobLogger.log("----------- script file:"+ scriptFileName +" -----------");
65 65
         int exitValue = ScriptUtil.execToFile(cmd, scriptFileName, logFileName, scriptParams);
66
-        ReturnT<String> result = (exitValue==0)?IJobHandler.SUCCESS:new ReturnT<String>(IJobHandler.FAIL.getCode(), "script exit value("+exitValue+") is failed");
67
-        return result;
66
+
67
+        if (exitValue == 0) {
68
+            return IJobHandler.SUCCESS;
69
+        } else if (exitValue == 501) {
70
+            return IJobHandler.FAIL_RETRY;
71
+        } else {
72
+            return new ReturnT<String>(IJobHandler.FAIL.getCode(), "script exit value("+exitValue+") is failed");
73
+        }
74
+
68 75
     }
69 76
 
70 77
 }