function 模块
简介
Baetyl-function 是 Baetyl 框架端侧的函数计算框架。端侧函数计算框架由前端代理和后端函数运行时两部分组成。
Baetyl-function 提供前端代理,是函数入口,通过暴露 HTTP 接口供其他服务调用,然后将请求透传给后端的函数运行时模块。
后端函数运行时提供多种选择:
baetyl-function-python36 提供 Python3.6 函数运行时;
baetyl-function-node10 提供 Node 10 函数运行时;
baetyl-function-sql 提供 SQL 函数运行时,兼容 SQL92 语法。
用户可以编写 python、node、sql 脚本来构建自己的业务逻辑,进行消息的过滤、转换和转发等,使用非常灵活。
函数计算基于事件驱动编程模型设置。用户可以使用 Baetyl 端侧规则引擎 baetyl-rule 模块设定规则,当由消息触发某条规则的时候,可以在该条规则内调用相关函数。Baetyl-rule 会按照如下格式请求 baetyl-function 模块:
https://[baetyl-function-service]/[function-service]/[function]
其中 baetyl-function-service
是 baetyl-function 的服务地址,例如 baetyl-function:50011,function-service
是后端函数运行时服务的名称,function
表示函数入口,如果 funciton
字段不指定的话,后端函数运行时会默认选择自身函数列表中的第一个函数。函数入口表示执行函数,对于 Python/Node 运行时来说,由函数脚本和处理函数名组成,对于 SQL 运行时来说,只有函数脚本组成,函数脚本内即是用户编写的 sql 语句。
具体使用可以参考最佳实践 Baetyl 边缘规则引擎实践 。
配置
Baetyl-function 的全量配置文件如下,并对配置字段做了相应解释:
server: # server 相关设置,由于把请求代理到后端的 Runtimes 模块
address: ":50011" # 监听地址
concurrency: # 服务端并发连接数,如果不设置的话将使用默认值
disableKeepalive: true # 是否启用 keep-alive 连接,默认值为 false
tcpKeepalive: false # 是否主动发送 keep-alive 消息,默认为 false
maxRequestBodySize: # Body 最大数据量,默认为 4 * 1024 * 1024 Byte
readTimeout: 1h # 服务端连接的读超时时间,默认值为无限制
writeTimeout: 1h # 服务端连接的写超时时间,默认值为无限制
idleTimeout: 1h # 在 keep alive 启动条件下,服务端等待下次消息的空闲超时时间,如果值为0,复用读超时时间
ca: example/var/lib/baetyl/testcert/ca.crt # Server 的 CA 证书路径
key: example/var/lib/baetyl/testcert/server.key # Server 的服务端私钥路径
cert: example/var/lib/baetyl/testcert/server.crt # Server 的服务端公钥路径
client: # 请求后端 Runtimes 模块的客户端相关设置
grpc: # Grpc 客户端设置
port: 80 # 后端 Runtimes 端口
timeout: 5m # 请求超时时间
retries: 3 # 请求重试次数
logger: # 日志
level: info # 日志等级