Docs: 核心概念

Mon, 01 Jan 0001 00:00:00 +0000

控制中心 [ QueenBee ]

控制中心是一个区域的中枢节点，它管理着区域内所有的工作设备。
控制中心可以将计算任务分配给合适的工作节点，并收集任务的执行结果。
控制中心提供两类接口：
工作设备接口: 一套供工作设备使用的 REST API
用户接口: 一套供您（或您的业务系统）使用的 REST API，可以查看工作设备状态，可以管理和执行任务。

工作设备 [ WorkerBee ]

工作设备是若干安装了 WorkerBee 应用的终端，它的特点是分布广、数量大、类型多样。 WorkerBee 会利用终端的空闲网络带宽和计算能力，从控制中心获取任务并在执行后报告结果。

您可以在若干服务器或个人电脑上部署 WorkerBee CLI 程序并运行。也可以在您的移动 APP 中集成 WorkerBee SDK, 在取得最终用户的许可下，正在运行您的 APP 的移动设备就会成为一个工作设备。

对于工作设备，还有一个 能力 的概念。由于工作设备的多样性，不同的设备可能会有能力差别，我们用一个标签列表来标识工作设备的所有特殊能力，比如可以在浏览器中执行任务，或者它可以用 GPU 进行计算。

任务 [ Job ]

任务是服务端分配给工作节点的基本计算单元，它由您通过接口定义和调用。关于任务还有几个衍生概念：

任务定义: 您可以通过接口定义任务，定义好的任务可以被多次调用。
任务参数: 在任务定义中可以预留一些可变的参数，在调用时提供具体的值。比如访问中国天气网某个城市的天气页面。
任务步骤: 在一个任务定义中，可以有多个步骤，每个步骤完成一个相对独立的子任务。每个步骤还可以利用之前步骤的计算结果。
任务结果: 在任务执行完成后会有任务结果记录任务执行是否成功，如果成功了可能还包含预期的结果数据，如果失败了一定会包含失败原因。
任务触发器: 任务除了通过接口调用，还可以设置自动触发条件让控制中心自动触发。比如每天中午12点定时执行。

本系统不做业务层面的任务编排或调度，比如业务上一个测试某网址在全国的访问延迟的任务，需要业务系统拆分成三十多个任务，

Docs: 运作方式

Mon, 01 Jan 0001 00:00:00 +0000

工作设备和控制中心是怎么联系的？

由于工作设备数量巨大，WorkerBee 被安装到工作设备时一般是批量安装或用户自行安装的，在安装时安装包内就预置了控制中心的地址和一个 分组 Token 。
WorkerBee 在每次启动时，都会用 分组 Token 去调用登录接口，换取独属于自己的 Token 。
WorkerBee 会周期性的主动向控制中心请求任务，控制中心依靠 Token 识别出工作设备后，分配给它合适的任务。
在完成任务之后会向控制中心报告，并继续请求任务。
WorkerBee 随时有可能因各种原因退出，不用担心未完成的任务，控制中心在任务超时后重新将任务分给别的工作设备。

任务在控制中心内是怎么流转的？

图中黄色部分为任务较稳定的状态，有排队中 queuing , 运行中 running , 失败 failed , 成功 successed 几个状态。
每个任务会有超时时限，工作设备如果发现任务到了超时时限会主动上报任务失败。此图中的超时含义其实为客户端失联，这种情况总是会重新排队。
由于雾计算工作设备的不稳定性，在工作设备失败后还是会重新排队重试预定的次数。
工作设备报告任务成功后，会在控制中心执行可能存在的一些步骤，控制中心比较稳定可控，这个环节如果失败了会直接认为任务失败。

控制中心是如何把任务分配给工作设备的？

工作设备提交任务请求后，控制中心查询工作设备的地理区域，网络运营商，能力范围。
从排队最久的任务开始，顺次检查每个任务，如果任务的地理区域要求、网络运营商要求、能力范围要求全不能能被满足，则将任务分配给此工作设备。
分配后任务会被标记为运行中 running, 并从等待队列删除。
重试的任务会被插入等待队列头部。

BeeFog – 总览