节点管理

更新时间：2021-01-08

功能简介

节点是边缘设备在云端的映射，云端一个节点代表一个边缘设备。通过在云端创建节点，在边缘设备完成节点安装后，就可以对边缘设备进行管理。此外，还可以在云端查看已有的节点，编辑节点的信息，删除节点。

使用说明

对节点的操作包括创建节点，删除节点，对节点编辑，以及安装节点。

创建节点

在边缘节点页面点击创建节点，进入节点创建页面。

名称: 节点名称，不可为空，不可重复
描述：描述可以为空
标签：对节点进行标识，用于关联应用，可以不绑定标签，也可以绑定多个标签
认证方式: 节点端云同步使用证书（强制）

点击确定完成节点创建后可以在节点列表看到已创建节点。

删除节点

在节点列表页面点击删除，弹出确定窗口。

点击确定后完成节点删除。

节点编辑

点击节点进入节点详情页可对节点描述信息和标签进行编辑，可以添加新的标签，修改已有标签键值，或删除已有标签。

节点安装

节点安装目前支持 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均处于运行状态即表示节点安装完成。

查看节点

在节点详情页可以看到节点已连接，显示了节点的详细信息与资源使用情况。

点击左边栏应用部署菜单可以查看已部署的应用相关信息和资源使用情况。

![image.png](https://bce.bdstatic.com/doc/bce-doc/BIE/image_ead28c8.png

节点影子

节点影子可以看做边缘设备数据在云端的映射。通过节点影子，可以利用端云同步通道，将云端节点数据或属性同步至边缘设设备。边缘设备上的应用可以通过相关接口获取来自云端的数据，同时也可以利用接口对数据进行更新，而后同步至云端。简而言之，节点影子可以作为一种在端云同步用户自定义数据的方式。

同步的数据格式为键值对，且数据类型均为字符串。数据内容不限，例如当需要同步配置文件，可以指定属性名称为配置文件名，期望值为文件内容。设备端即可以接收来自云端同步的配置文件，使用配置文件对应用进行热更新。

具体使用方式如下，在云端节点页面点击节点影子标签，显示该节点现有属性为空，在边缘设备对节点影子对应3种操作。首先是边缘应用订阅系统 MQTT broker 相关主题，接收来自云端的属性更新消息。第二种是通过OpenAPI获取云端该节点的所有属性。第三种是通过OpenAPI更新属性，修改的属性会作为上报值发送至云端展示。

1.接收节点影子数据增量更新消息

为模拟应用订阅系统 MQTT broker，先将系统broker配置进行调整。注意，这里仅仅是为了便于操作，实际应用订阅主题推荐使用TLS连接系统 MQTT broker，下文会有介绍。

点击编辑，添加属性

确定后，即可在属性列表查看相关属性

而后会通过端云协同将所有属性同步至边缘设备，且以增量更新的方式通知。具体为通过MQTT订阅相关主题，接收事件消息，消息内容即为需要更新的属性键值对。

通常是边缘运行应用订阅系统MQTT broker，在这里对节点系统broker应用配置进行修改，便于订阅主题。

点击节点应用部署，并进入系统broker应用（名称中有broker）进行配置修改

点击应用配置

添加端口配置，配置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下有连接所需要的证书。