🧠 批处理算法组件的设计动机

• 异常处理 ：大多数算法开发人员在程序开发过程中通常只关注程序的正常逻辑，而忽视了程序在运行过程中可能遇到的异常情况以及如何处理这些异常故障。
• 缺乏生命周期管理 ：缺乏提供生命周期管理接口，用户无法方便地查询程序的运行状态，也无法进行必要的生命周期管理操作，例如暂停、恢复或停止程序的执行。若在程序执行过程中发现逻辑错误或需要优先执行其他任务，用户只能通过终止进程的方式停止程序的执行。

🏗️ 批处理算法组件的模型结构

批处理算法组件是 面向海量数据批处理场景 的 具有生命周期管理 和 检查点恢复机制 的功能软件单元

📋 属性

属性是组件内部维护的数据成员，包含以下类型

• 组件启动配置属性
• 组件运行过程属性
• 数据处理属性。

组件启动配置属性

在组件启动时，外部环境将参数传递给组件，随后组件进入初始化阶段，利用这些参数为组件的启动配置属性进行赋值

• mode：组件运行模式
  • 算法执行模式 （algorithm）：正常执行算法过程
  • 数据清理模式（clean）：若组件的算法逻辑有误导致错误的数据输出或中间输出结果没有业务价值，则需要清理这些数据，减轻集群节点机器的磁盘资源压力。
• restore：检查点标志位
  • 1：组件在运行之前，会尝试读取本地的检查点文件，并从检查点处恢复执行
  • 0：组件此次运行会重新开始处理所有数据
• properties_url：数据处理参数的配置文件地址

📊 组件运行过程属性

组件运行过程属性是用于记录组件的运行状态、运行进度等相关信息的属性集合

💾 数据处理属性

数据处理属性是组件进行数据处理时需要使用的属性

• 输入数据地址
• 输出结果地址
• 可选的算法模型动态参数

接口

接口定义了组件的各项行为

🔄 生命周期管理

组件运行时会启动一个HTTP服务，并提供生命周期管理接口给外界控制和获取组件运行状态

• info ：获取组件运行状态，包括组件运行进度、运行状态等信息
• pause：暂停组件运行
• restart：恢复运行处于暂停状态的组件
• stop：停止组件运行

数据处理

数据处理接口是组件读取、处理以及写入数据的接口集合

• getConfig：获取数据处理属性。
• getGenerator：返回一个获取批处理任务所需数据的生成器。组件进行数据处理时，数据被分成块进行处理。开发人员实现该接口时，可以根据需要指定块的粒度。
• readItem：从生成器中遍历得到数据的存放地址，并将数据读取至内存中。
• beforeProcess：输入数据的预处理环节。
• process：主要的数据分析处理环节，开发人员要在该接口内实现批处理算法逻辑。
• afterProcess：收尾工作，例如可将处理完毕的图片从内存中移除，避免过多的图片将内存占满
• clean：清理组件执行过程中生成的所有数据
• handleFinish：当数据的批处理任务后，将要退出前调用此接口进行收尾工作

▶️ 算法运行模式

1. 通过getGenerator接口获取数据生成器，并遍历该生成器
2. 在每次遍历时，按照以下步骤进行数据处理操作。
   1. 通过readItem接口将数据块读入内存。
   2. 将读入的数据传入beforeProcress接口进行预处理操作。
   3. 预处理完毕后，将处理结果传入process接口进行数据分析处理，执行具体的数据处理算法或操作。
   4. 处理完毕的数据会进入到afterProcess接口进行收尾工作，如释放内存等。
3. 进入下一次循环之前，组件程序会判断当前的运行状态。
   1. 如果状态为暂停，线程将被阻塞，直到状态重新变为运行中。
   2. 如果状态为停止或生成器已遍历完成，则进入使用handleFinish接口进行程序的收尾工作。

🧹 数据清理模式

1. 通过getGenerator接口获取待清理数据生成器，并遍历该生成器。
2. 在每次遍历时
   1. 将数据块地址传入clean接口进行数据清理工作。
3. 数据清理完毕后，在进入下一次循环之前，需要判断组件运行状态
   1. 如果状态为暂停，线程将被阻塞，直到状态重新变为运行中。
   2. 如果状态为停止或生成器已遍历完成，则进入使用handleFinish接口进行程序的收尾工作。

📍 检查点管理

检查点接口是负责组件运行过程中检查点设置和读取的接口集合

• setCheckpoint：设置检查点内容，保存组件当前的运行状态。
• getCheckpoint：读取检查点内容，组件重新启动时，调用该接口恢复组件运行状态。

事件发布

• lifeCycleEventPublish：发布组件运行生命周期事件。
• runPorgressEventPublish：发布组件运行进度事件。

事件

事件是批处理算法组件具备的主动向外界传递信息的能力，采用发布/订阅机制。

消息队列接受组件模型发布的事件

订阅者通过订阅获取事件

🚪 组件运行入口

组件的运行入口是一个main函数，外界通过调用组件的main函数启动组件运行。

1. 首先接收外界传递的参数，以进行组件的初始化阶段。
2. 启动一个HTTP服务线程，以便外界可以与组件进行通信。
3. 通过判断mode属性值来确定组件进入哪种运行模式
   1. 如果mode为algorithm，进入算法执行模式；
   2. 如果mode为clean，进入数据清理模式。

⚙️ 批处理算法组件的模型机制

生命周期管理机制

• 初始化 （init） ：处于该状态的组件进行必要的初始化操作。
• 运行中 （running） ：处于该状态的组件按照既定的算法逻辑处理数据。
• 运行暂停 （paused） ：一旦组件进入暂停状态，线程将会持续阻塞，无法继续执行下一步操作。
• 运行停止 （stopped） ：组件主动终止当前的执行进入停止状态，组件进程将会退出
• 运行完成 （finished） ：当组件处理完所有的数据后，进入运行完成状态，进行收尾工作并退出进程。
• 运行失败 （failed） ：运行失败状态表示组件在执行过程中遇到了错误、异常或不可恢复的问题，导致无法继续正常运行

💾 检查点恢复机制

检查点恢复机制确保组件运行时，即使组件运行停止或突然遇到故障导致组件崩溃退出，也能够在下一次重新启动时恢复到最近一个检查点的状态继续执行

设置检查点

在每次数据处理循环结束之前，调用设置检查点接口 setCheckpoint 将当前组件处理输入数据的进度作为检查点文件保存在本地文件系统中。组件模型内部维护一个检查点对象，在保存检查点时，会将该对象进行序列化并以 Json 文件格式持久到本地的文件系统

后续开发人员可以增加检查点中的数据成员用于保存数据处理的中间处理结果，并在 setCheckpoint 和 getCheckpoint 接口实现相应代码逻辑

读取检查点

当组件恢复运行时，若属性restore的值为1，则判断本地是否存在该组件运行的检查点文件，存在则读取检查点文件并进行反序列化得到检查点对象

🗺️ 批处理算法组件的编排模型

由算法程序封装得到的批处理算法组件只能提供单一的算法功能，无法单独完成完整的数据处理任务。

因此在完成各个组件的独立开发后，还需要允许用户根据具体需求选择组件，并对多个组件进行编排，通过复用已有组件，处理复杂的数据处理任务。

🏗️ 组件编排模型的结构设计

在组件编排模型中，多个组件之间以有向无环图（DAG）的方式进行编排

有向箭头表示组件之间的依赖关系，例如，组件A指向组件B的有向箭头表示组件B需要在组件A的运行结果的基础上进行数据处理和分析，即组件A的运行输出结果作为组件B的运行输入数据。

⚙️ 组件编排模型的结构实现

组件编排信息通过规范化的 Json 语言进行描述

• connections：组件执行顺序
  • fromIndex：起始组件序号
  • toIndex：结束组件序号
• components：组件列表
  • componentId：组件唯一标识
  • index：组件序号
  • mode：组件运行模式
  • machine：执行组件的计算节点名称
  • args：组件数据处理参数

示例

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

{ 
    "connections": [ 
        { 
            "fromIndex": 0, 
            "toIndex": 1 
        }, 
        { 
            "fromIndex": 1, 
            "toIndex": 2 
        } 
    ], 
    "components": [ 
        { 
            // 道路水平面切片生成组件 
            "componentId": "", 
            "index": 0, 
            "mode": "algorithm", 
            "machine": "", 
            "args": 
            { 
                "input": "",
                "output": "", 
                "secatt": 1, 
                "canvasrl": 30, 
                "canvasrw": 30, 
                "begins": [ 30, 61, 90, 120 ], 
                "ends": [ 40, 71, 100, 130 ], 
                "canvasstep": 1, 
                "interratiol": 4, 
                "interratiow": 6, 
                "centralFilepath": "#", 
            } 
        },
        { 
            // 道路裂缝识别组件 
            "componentId": "", 
            "index": 1, 
            "mode": "algorithm", 
            "machine": "", 
            "args": { 
                "input": "", 
                "output": "", 
                "alpha":"0.3" 
            } 
        }, 
        { 
            // 裂缝线状形态拟合组件 
            "componentId": "",
            "index": 2, 
            "mode": "algorithm", 
            "machine": "", 
            "args": 
            { 
                "input": "", 
                "output": "", 
                "rho": 0.8, 
                "theta": 180, 
                "threshold": 40, 
                "minLineLength": 40, 
                "maxLineGap": 10, 
                "delta1": 0.1, 
                "delta2": 40 
            } 
        } 
    ] 
}