Lotus分析

时间:2022-03-12 17:50:00

一 Lotus的任务

Lotus是一个消息通知服务,topic和subscription是多对多的关系。后面我加了一个发送自定义邮件和自定义短信的功能。

产品里面有个监控报警和通知列表。监控报警里创建alarm时会让选通知给谁。供选择的就是topic。如果alarm被触发,就会发通知给和该alarm绑定的topic,topic再查找它的所有subscription,都发通知。


Lotus代码分析

1.lotus的两个进程

lotus-api

lotus-dbsync

2. lotus-dbsync

数据流程:

/usr/local/bin/lotus-dbsync启动,会去调用/lotus/cmd/manage.py的main函数。

main里会调用/lotus/db/migration.py里的dbsync函数。

migration.py里的dbsync调用了/lotus/common/utils里的LazyPluggable来动态获取backend以实现升级或降低到指定版本。

sqlalchemy='lotus.db.sqlalchemy.migration'作为LazyPluggable的第四个参数,会在
lotus.db.sqlalchemy.migration里进行版本比较来实现升级或降级。

最底层的升级或降级或在migrate这个第三方库里实现,这里只调用接口即可。

这个进程的任务是对数据库的升级或降级。取决于指定的版本号。不过一般用来升级到最新。

3. lotus-api

lotus-api可以理解成跑在simple_server上的一个pecan
app。它的任务是给前端提供restful
api。

用的是pecan的路由规则。

比如:v1/topics,就会到v1这个目录里找topics.py,然后在根据是什么方法(POST/PUT等)或参数(topic_id)来确定具体调用哪个API。

目前只有有四个root
controller:statistics,topics,subscriptions,publish

(1)statistics:主要用来创建metric

(2)
topics:TopicsController里面有个lookup,可以根据topic_id路由到TopicController

TopicsController里面有两个提供给前端用的接口post和get_all。

post是创建一个topic。

TopicController:get,delete,put,publish

get:获取一个topic(由topic_id指定)的详细信息

delete:删除一个topic(由topic_id指定)

put:修改一个topic(由topic_id指定)

publish:给topic(topic_id指定)的所有subscription发alarm信息

都是对单个topic的操作。

所以我怀疑是否将TopicsController里面的post移到TopicController里面会更合适?

(3)
subscriptions:

一级SubsController,
二级是ConfirmController 和SubController。

url查找到SubController后会根据sub_id
lookup到SubController。

而ConfirmController的路由是由SubsController里面confirm
= ConfirmController()指定。

这一部分主要是订阅topic,确认等内容。subscription里面最重要的一个参数是endpoint。因为消息是发送到这个endpoint,可以是邮箱或短信方式。这里共两种protocol:email和sms。

(4)publish:

自定义发送邮件和短信。这部分是我写的,比较简单。

Publish.py
里面有严重的瑕疵,我自己造成的。

L8-L9 只能import
module(PEP8规定)

L23-L24 8,9导致这SMS()
Email() 严重不规范。

三.
DB

所有的服务都是基于数据。

lotus太小,目前只有三个table:Topic,Subscription,Topic_Sub

Topic存储topic相关字段

Subscription存储
subscription相关字段

Topic_Sub存储topic和subscription的绑定