节点管理
功能简介
节点是边缘设备在云端的映射,云端一个节点代表一个边缘设备。通过在云端创建节点,在边缘设备完成节点安装后,就可以对边缘设备进行管理。此外,还可以在云端查看已有的节点,编辑节点的信息,删除节点。
使用说明
对节点的操作包括创建节点,删除节点,对节点编辑,以及安装节点。
创建节点
在边缘节点页面点击创建节点,进入节点创建页面。
- 名称: 节点名称,不可为空,不可重复
- 描述:描述可以为空
- 标签:对节点进行标识,用于关联应用,可以不绑定标签,也可以绑定多个标签
- 认证方式: 节点端云同步使用证书(强制)
点击确定完成节点创建后可以在节点列表看到已创建节点。
删除节点
在节点列表页面点击删除,弹出确定窗口。
点击确定后完成节点删除。
节点编辑
点击节点进入节点详情页可对节点描述信息和标签进行编辑,可以添加新的标签,修改已有标签键值,或删除已有标签。
节点安装
节点安装目前支持 Kube 模式在线安装。baetyl运行模式包括 k3s+docker 和 k3s+containerd 两种,用户根据实际需要选择运行环境安装命令,需要注意的是,若用户选择 k3s+docker 运行环境,需先安装 docker 后再安装 k3s。
- 节点安装-containerd
- 节点安装-docker
运行环境准备就绪后,执行节点安装命令,即可安装边缘节点,效果如下:
采用上述两种模式安装都会在 baetyl-edge-system 部署 baetyl-core, baetyl-init, baetyl-function, baetyl-rule及baetyl-broker五个服务。查看 baetyl-edge-system 命名空间下的pod均处于运行状态即表示节点安装完成。
查看节点
在节点详情页可以看到节点已连接,显示了节点的详细信息与资源使用情况。
点击左边栏应用部署菜单可以查看已部署的应用相关信息和资源使用情况。
进行配置修改
点击应用配置
添加端口配置,配置1883->1883端口映射,并点击确定
然后,切换到数据卷标签,并进入conf配置卷(名称中有conf)进行配置修改
点击编辑
添加listeners
内容为
listeners:
- address: 'tcp://0.0.0.0:1883'
session:
sysTopics:
- $link
- $baetyl
logger:
level: debug
encoding: console
改好后点击保存,并确定
打开MQTT.Box,配置设备host
确认已连接至设备MQTT broker,并订阅 $baetyl/node/props 主题
、
之后会接收到来自该主题的消息,内容为云端节点属性
实际场景
边缘应用订阅系统MQTT broker时通常是使用双向TLS方式,确保数据安全传输。通过baetyl官方sdk提供接口可以直接以安全方式连接。另外也可以指定连接地址为ssl://baetyl-broker.baetyl-edge-system:50010,并配置连接证书。通过BIE部署的应用在/var/lib/baetyl/system/certs下有连接所需要的证书。
2.通过OpenAPI获取节点影子属性
通过OpenAPI需要通过证书以HTTPS方式连击至server。通过BIE部署的应用在/var/lib/baetyl/system/certs路径下有所需的ca.pem证书,使用HTTPS协议连接地址为https://baetyl-core.baetyl-edge-system。获取节点影子属性的接口为 https://baetyl-core.baetyl-edge-system/node/properties
这里以模拟方式,跳过对服务端证书校验,且由于baetyl-core应用配置了端口映射30050->80
在desire有云端期望数据。
3.通过OpenAPI更新节点影子属性
类似于获取节点影子属性,使用证书以HTTPS协议可以对节点影子数据进行更新,接口同样为 https://baetyl-core.baetyl-edge-system/node/properties
同样以以模拟方式,跳过对服务端证书校验
指定需要更新的属性,接口会返回当前节点影子所有属性。同时,在云端的节点影子可以看到边缘设备对属性的更新。