任务调度系统需求规格说明书

1、统一任务调度系统需求规格说明书文件编号：生效日期：版本号：V0.1修改状态：0密级：编制：李晓海日期：2013/04/08审核：日期：批准：日期：北京联动优势科技有限公司联动UIVP版本控制信息版本日期描述作者V0.12013-04-08创建李晓海本文档中的所有内容为北京联动优势科技有限公司的机密和专属所有。 未经北京联动优势科技有限公司的明确书面许可，任何组织或个人不得以任何目的、任何形式及任何手段复制或传播本文档部分或全部内容。本规范解释权属北京联动优势科技有限公司所有。1前言 51.1文档目的 51.2阅读对象 51.3名词解释 52需求概述 62.1系统结构 62.2角色分析 62.3

2、总体用例 73任务管理用例分析 73.1维护节点 83.1.1新建节点 83.1.2修改节点 83.1.3删除节点 83.2维护应用 93.2.1新增应用 93.2.2修改应用 93.2.3删除应用 103.3维护任务组 103.3.1新增任务组 103.3.2修改任务组 113.3.3删除任务组 113.3.4配置调度规则 113.4维护任务 123.4.1新增任务 123.4.2修改任务 123.4.3删除任务 133.4.4配置依赖关系 133.4.5卸载任务 133.4.6停止/恢复任务 144任务调度用例分析 144.1.1 运行任务 141.%2.任 务监控用例分析 151查看任务

3、 151.3查看任务执行统计信息 151.3查看任务执行信息 151查看日志 161.4查看执行日志 161.4查看重跑日志 161.4查看业务日志 172.%2.任 务 干涉用例分析 172重跑任务 172暂停/恢复任务 182.4暂停顶级任务组 182.4恢复顶级任务组 182.4暂停任务 192.4回复任务 192跳过任务 203.%2.非功能需求 201 刖百文档目的该文档主要对公司内部统一任务调度系统(UMPAY-JSM)的相关需求进行了分析，为之后概要设计和详细设计提供依据。阅读对象参与统一调度系统的设计人员参与统一调度系统的产品负责人和业务人员参与统一调度系统的开发人员。参与统一

4、调度系统的测试人员。名词解释UMPAY-JSM:统一任务调度系统。为公司内部管理类系统和业务系统提供统一的任务注册管理，运行监控和任务干涉等相关功能。分布式：任务调度系统为分布式系统，增加、维护新的调度任务的时候不影响正在运行的其他调度任务。服务器端：负责节点、应用、任务组以及任务的注册维护和任务执行情况的监控。节点端：任务真正执行处，多个应用部署在某个节点。负责任务的部署，卸载和执行。JOBLET:最小的任务执行单元，一个 Joblet 代表一个完整的任务执行逻辑。应用：一组任务组或者任务的逻辑分组，代表一个应用系统，归属于某个业务系统的需要定时调度的任务组成一个应用。如 OA 系统、账户管

5、理系统等。任务组：任务的逻辑分组，包含多个任务组或者任务。是某个任务调度的逻辑单元。任务规则配置在任务组中。在进行任务调度的时候根据调度规则启动任务组。任务：在服务器端注册的最小任务单元，代表需要执行的最小单位。对应一个 Jobleto调度规则：指定任务执行的时间，问隔、周期等信息。2 需求概述系统结构任田节点任第节总任第货启:系统总体架构为分布式系统，分为服务器端和任务运行节点服务器（任务节点）。服务器端负责任务信息配置、任务调度、任务权限配置以及日志查看。任务节点运行具体任务，产生和保存业务日志。双方通过 http 或者 TCP 等协议进行远程通讯。任务调度支持自动执行和手动干预。根据任务

6、调度规则配置，在指定的时间点，调度服务器就把任务请求发送请求到相应的任务节点，各个任务节点上接到请求后，先返回一个响应，通知服务器是否能够启动任务，接着处理相应的任务，并根据执行的情况会返回执行结果，如有异常，可 以 返 回 异 常 结 果 ， 记 录 日 志 ， 运 维 人 员 前 端 进 行 日 志 下 载 ， 方 便 查 找 问 题 。手工调度：根据权限，业务任务可以手动干预任务，包括重跑任务、暂停任务、停止任务、安装、卸载任务、重新安装任务等。角色分析角色名称说明管理员1:节点，应用、任务等注册维护工作2:女责节点、应用、任务的停用、卸载重新安装工作3:监控任务的执行情况，查看执行日志

7、4:十块任务， 对任务进行暂停， 重跑恢复等。时间根据调度规则，启动执行任务。开发人员使用系统框架，开发部署任务 joblet。总体用例总体需求分为任务管理、任务调度、任务监控和任务干预四个模块，具体需求描述如下：任务管理：管理员对需要调度的任务进行注册维护，包括注册维护基本信息以及任务的调度规则和任务依赖关系。另外管理员可以卸载、停用或者重新安装指定的任务。任务调度：根据调度规则，系统定时执行任务并且记录任务的执行日志。任务监控：管理员在任务控制台查看任务的执行情况，包括任务的总体执行统计信息或者指定某个具体的任务，查看任务历史执行情况。任务干预：根据需要，管理员可以对某个正在执行的任务进行

8、干预，包括暂停某个任务，跳过任务以及重新运行某个任务等。3 任务管理用例分析在任务能够被调度执行之前需要将任务注册到服务器端，管理员负责注册任务,配置任务调度规则。并且管理员能够对任务进行卸载，重新安装等。具体分为:0IM事T而图in!lucle才_一一*TJlrrh-维护节点管理员对节点基本信息进行维护。节点的核心属性包括：名称，IP 地址，协议（如 http、cm20 等），端口号、上下文等。新建节点用例编号01-01用例名称新建节点用例描述新建节点参与者管理员前置条件条件基本流程管理员系统1,输入节点信息2,保存节点信息3,提示处理结果信息说明修改节点用例编号01-02用例名称修改节点用

9、例描述修改节点参与者管理员前置条件节点信息保存完毕后置条件基本流程管理员系统1,1,选择节点2,输入节点信息3,保存节点信息4,提示处理结果信息说明删除节点用例编号 01-03用例名称删除节点用例描述删除节点参与者管理员前置条件节点信息保存完毕后置条件基本流程管理员系统1,选择节点2,保存节点信息3,提示处理结果信息同时级联删除节,照下的应用、任务以及任务组信息说明一维护应用管理员在指定节点下，对应用信息进行维护。核心属性包括：名称，上下文。应用必须归属与具体的节点，一个节点可以包括多个应用。新增应用用例编号02-01用例名称新增应用用例描述新增应用参与者管理员前置条件节点信息保存完毕后置条件

10、基本流程管理员系统1,输入应用信息2,保存应用信息3,提示处理结果信息必须选择某个节点。说明修改应用用例编号02-02用例名称新增应用用例描述新增应用参与者管理员前置条件节点信息保存完毕后置条件基本流程管理员系统1,输入应用信息2,保存应用信息3,提示处理结果信息说明删除应用用例编号02-03用例名称新增应用用例描述新增应用参与者管理员前置条件节点信息保存完毕条件基本流程管理员系统1,输入应用信息2,保存应用信息3,提示处理结果信息级联删除应用下的任务组。说明维护任务组任务组指的是任务的逻辑划分单元，必须归属于某个应用。任务组 fenweu 顶级任务组和普通任务组。一个任务组包含多个任务组或者

11、多个任务。任务组核心属性包括名称，上级任务组，是否顶级任务组，调度规则等。维护任务组指的是管理员对任务组进行注册，维护删除操作。新增任务组用例编号03-01用例名称新增任务组用例描述新增任务组参与者管理员前置条件应用信息保存完毕后置条件基本流程管理员系统1,输入任务组信息2,保存任务组信息3,提示处理结果信息说明必须选择某个应用或者指定上级任务组3.3.2修改任务组用例编号03-02用例名称修改任务组用例描述修改任务组参与者管理员前置条件任务组信息保存完毕条件基本流程管理员系统1,输入任务组信息2,保存任务组信息3,提示处理结果信息说明3.3.3删除任务组用例编号03-03用例名称删除任务组用

12、例描述删除任务组参与者管理员前置条件任务组信息保存完毕5 条件基本流程管理员系统1,选择任务组2,删除任务组3,提示处理结果信息级联删除子任务组和任务说明3.3.4配置调度规则用例编号03-04用例名称配置调度规则用例描述配置调度规则，可以选择是轮训方式或者 cronTab 方式，两者是互斥的。参与者管理员一前置条件任务组信息保存完毕|后置条件基本流程管理员1,输入调度规则信息系统2,保存任务组信息3,提示处理结果信息说明维护任务管理员对任务进行注册，维护，删除或者卸载，重新启动，停止等操作。新增任务用例编号04-01用例名称新增任务用例描述新增任务参与者管理员前置条件任务组信息保存完毕5 条

13、件基本流程管理员系统1,1,输入任务信息2,保存任务信息4,提示处理结果信息说明3.4.2修改任务用例编号04-02用例名称修改任务用例描述修改任务参与者管理员前置条件任务信息保存完毕后置条件基本流程管理员系统1,输入任务信息2,保存应用信息3,提示处理结果信息说明3.4.3删除任务用例编号04-03用例名称删除任务用例描述删除任务参与者管理员前置条件任务信息保存完毕后置条件基本流程管理员系统1,选择任务2,保存任务信息3,提示处理结果信息级联删除任务参数和任务日志信息说明3.4.4配置依赖关系用例编号04-04用例名称配置依赖关系用例描述配置任务和任务，任务和任务组之间的依赖关系，在任务调度

14、的时候需要根据依赖关系依次调用任务。：参与者管理员前置条件任务信息保存完毕后置条件基本流程说明管理员系统1,输入应用依赖信息2,保存任务信息3,提示处理结果信息3.4.5卸载任务用例编号04-05用例名称卸载任务用例描述将任务进行卸载，下次任务调度的时候将不会启动此任务。参与者管理员前置条件任务信息保存完毕5 条件基本流程管理员系统1,选择任务2,保存任务信息3,提示处理结果信息11|3.4.6停止/恢复任务用例编号04-06用例名称停止/恢复任务用例描述将任务进行停止或者恢复。一般是在任务 joblet 发生变更或者出现严重错误，需要重新开发 joblet 的时候，可以将任务进行停止，修复完

15、毕后再将任务恢复、下次任务调度的时候将不会启动此任务。参与者管理员前置条件任务信息保存完毕后置条件基本流程管理员系统1,选择任务2,保存任务信息3,提示处理结果信息说明一4 任务调度用例分析任务调度是根据调度规则（定时扫描或者 cronTab）,系统定时启动任务组或者任务（单独任务不能独立启动，至少需要包含在某个任务组中）。任务执行完毕后，系统收集任务执行的参数并且记录任务执行日志供管理员查看。4.1.1运行任务用例编号05-01用例名称运行任务用例描述系统自动启动任务参与者时间前置条件以上配置信息配置完毕后置条件基本流程时间系统1,获得需要启动的任务信息2,发送任务启动请求-13,启动任务4

16、,发送任务执行结果5,记录任务执行相关信息6 记录任务日志说明5 任务监控用例分析查看任务查看任务执行统计信息用例编号06-01用例名称查看任务执行统计信息用例描述管理员在任务控制台可以查看当前系统任务的执行情况总体信息，包括正在运行的任务数，执行成功的任务数，执行失败的任务数等。参与者管理员前置条件后置条件基本流程说明管理员系统1,1,进入任务控制台2,查询任务执行总体信息3,显示任务执行统计信息查看任务执行信息用例编号06-02用例名称查看任务执行信息用例描述查看某个具体任务或者任务组的执行情况，包括任务本身的执行状态，所属任务组的执行状态等。参与者管理员前置条件条件基本流程管理员1,选择

17、任务或者任务组系统2,查询任务执行信息4,显示任务执行信息说明查看日志日志为任务执行的情况记录，分为执行日志，重跑日志和业务日志。执行日志记录任务的开始时间，结束时间，执行结果，错误信息等重跑日志记录在执行重新运行任务的时候的日志信息。业务日志记录具体任务执行发生的业务相关信息。其中执行日志和重跑日志由调度服务器端统一维护保存，业务日志因为涉及到具体的业务逻辑，由节点端具体的 joblet产生，管理员通过任务控制台可以查看上述三种日志。5.2.1查看执行日志用例编号06-03用例名称查看执行日志用例描述查看执行日志参与者管理员前置条件后置条件基本流程管理员系统1,查询任务或者任务组2,选择任务

18、或者任务组3,查询执行日志4,显示任务执行日志信息说明5.2.2查看重跑日志用例编号06-04用例名称查看重跑日志用例描述查看重跑日志。参与者管理员前置条件后置条件基本流程管理员1,查询任务任务或者任务组2,选择任务或者任务组系统3,查询任务重跑日志信息4,显示任务重跑日志信息说明5.2.3查看业务日志用例编号06-05用例名称查看业务日志信息用例描述查看某个具体任务或者任务组的业务日志。因为业务日志的发生依赖于执行日志，所以需要根据执行日志获得业务日志信息。参与者管理员前置条件查看执行日志5 条件基本流程管理员系统1,选择执行日志2,查询任务业务日志信息4,显示任务业务日志信息说明6 任务干涉用例分析任务干涉指的是管理