瀏覽代碼

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

xuxueli 7 年之前
父節點
當前提交
ea5b3541e4

+ 13 - 3
doc/XXL-JOB官方文档.md 查看文件

785
 
785
 
786
 #### 5.5.3 GLUE模式(Shell) + GLUE模式(Python) + GLUE模式(NodeJS)
786
 #### 5.5.3 GLUE模式(Shell) + GLUE模式(Python) + GLUE模式(NodeJS)
787
 开发步骤:可参考 "章节三" ;
787
 开发步骤:可参考 "章节三" ;
788
-原理:脚本任务的源码托管在调度中心,脚本逻辑在执行器运行。当触发脚本任务时,执行器会加载脚本源码在执行器机器上生成一份脚本文件,然后通过Java代码调用该脚本;并且实时将脚本输出日志写到任务日志文件中,从而在调度中心可以实时监控脚本运行情况;脚本返回码为0时表示执行成功,其他标示执行失败。
788
+原理:脚本任务的源码托管在调度中心,脚本逻辑在执行器运行。当触发脚本任务时,执行器会加载脚本源码在执行器机器上生成一份脚本文件,然后通过Java代码调用该脚本;并且实时将脚本输出日志写到任务日志文件中,从而在调度中心可以实时监控脚本运行情况;
789
 
789
 
790
 目前支持的脚本类型如下:
790
 目前支持的脚本类型如下:
791
 
791
 
792
     - shell脚本:任务运行模式选择为 "GLUE模式(Shell)"时支持 "shell" 脚本任务;
792
     - shell脚本:任务运行模式选择为 "GLUE模式(Shell)"时支持 "shell" 脚本任务;
793
     - python脚本:任务运行模式选择为 "GLUE模式(Python)"时支持 "python" 脚本任务;
793
     - python脚本:任务运行模式选择为 "GLUE模式(Python)"时支持 "python" 脚本任务;
794
     - nodejs脚本:务运行模式选择为 "GLUE模式(NodeJS)"时支持 "nodejs" 脚本任务;
794
     - nodejs脚本:务运行模式选择为 "GLUE模式(NodeJS)"时支持 "nodejs" 脚本任务;
795
-    
795
+
796
+脚本任务通过 Exit Code 判断任务执行结果,状态码可参考章节 "5.15 任务执行结果说明";
796
 
797
 
797
 #### 5.5.4 执行器
798
 #### 5.5.4 执行器
798
 执行器实际上是一个内嵌的Jetty服务器,默认端口9999(配置项:xxl.job.executor.port)。
799
 执行器实际上是一个内嵌的Jetty服务器,默认端口9999(配置项:xxl.job.executor.port)。
917
 - 3、等待B组机器任务运行结束并编译上线;执行器注册地址替换为A组+B组;
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
 ### 6.1 版本 V1.1.x,新特性[2015-12-05]
932
 ### 6.1 版本 V1.1.x,新特性[2015-12-05]
1181
 - 3、[迭代中]任务超时设置,超时任务主动终止;
1191
 - 3、[迭代中]任务超时设置,超时任务主动终止;
1182
 - 4、任务属性枚举 "任务模式、阻塞策略" 国际化优化;
1192
 - 4、任务属性枚举 "任务模式、阻塞策略" 国际化优化;
1183
 - 5、任务日志表状态字段类型优化;
1193
 - 5、任务日志表状态字段类型优化;
1184
-- 6、[迭代中]脚本任务支持失败重试;
1194
+- 6、Glue(Shell) 等脚本任务支持失败重试;
1185
 - 7、告警邮箱支持SSL配置;
1195
 - 7、告警邮箱支持SSL配置;
1186
 - 8、Window机器下File.separator不兼容问题修复;
1196
 - 8、Window机器下File.separator不兼容问题修复;
1187
 
1197
 

+ 9 - 2
xxl-job-core/src/main/java/com/xxl/job/core/handler/impl/ScriptJobHandler.java 查看文件

63
         // invoke
63
         // invoke
64
         XxlJobLogger.log("----------- script file:"+ scriptFileName +" -----------");
64
         XxlJobLogger.log("----------- script file:"+ scriptFileName +" -----------");
65
         int exitValue = ScriptUtil.execToFile(cmd, scriptFileName, logFileName, scriptParams);
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
 }