容器模式节点

更新时间：2025-08-21

功能简介

节点是边缘设备在云端的映射，云端一个节点代表一个边缘系统，边缘系统支持两种场景：

单机场景下的单台设备
多机场景下的边缘集群

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

节点分为容器模式和进程模式，本章主要介绍容器模式的节点。当节点以容器模式运行时，边缘计算框架基于 Kubernetes，通过操作 Kubernetes 管理和运行程序的镜像。

节点状态

未激活：云端创建的节点还没有在边缘侧安装，云端从未收到边缘侧上报的节点信息
已激活
- 在线：边缘侧节点已安装，且与云端通信正常
- 离线：边缘侧节点已安装，与云端网络通信异常，云端暂时不能接受到边缘侧上报的消息

单机节点

单机类型的节点，适用于边缘侧为一台独立设备的场景。

对单节点的操作包括创建节点，删除节点，对节点编辑，以及安装节点，查看节点信息等。

选择并创建单机类节点在边缘测安装之后，就可以对这台设备进行管控，云端会展示该节点的信息。

单机场景时端侧默认会安装 baetyl-init 、 baetyl-core 、 baetyl-broker 、baetyl-agent四个模块。

创建节点

在边缘节点页面，选择容器模式，点击创建节点，进入节点创建页面。

名称: 节点名称，不可为空，不可重复
类型：选择单机
描述：描述可以为空
标签：对节点进行标识，用于关联应用，可以不绑定标签，也可以绑定多个标签
认证方式: 节点端云同步使用证书（强制）
选择官方模块：根据自身需要勾选所需的系统模块，勾选后将创建对应资源并在部署时进行安装。

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

节点编辑

点击节点进入节点详情页可对节点描述信息进行编辑。

在节点信息页可对标签进行编辑，可以添加新的标签，修改已有标签键值，或删除已有标签。

单机节点详情2.png

在应用部署页可以在应用状态栏查看已关联的应用，在服务状态栏可以查看已部署的服务运行状态，点击编辑按钮可以引入所需的系统模块。

单机节点详情3.png

在子设备管理页可以引入设备驱动，系统现在默认提供modbus驱动，这部分内容在子设备管理说明页有详细介绍。当前只有Kube模式支持子设备管理

单机节点详情4.png

在节点影子页可以对边缘节点影子进行查看和管理，也可以控制云边同步通道的开启和关闭，这部分内容在节点影子说明页有详细介绍。

单机节点详情5.png

节点查看

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

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

如果在创建节点时选择了NVIDIA GPU加速卡，可在节点详情页查看设备的GPU使用情况

查看节点GPU资源.png

点击节点详情页的AI加速卡栏，可以查看设备GPU更详细的信息，包括GPU卡名称，当前温度，能耗等。

查看GPU加速卡信息.png

节点安装

在容器模式下 baetyl 运行模式包括 k3s+docker 和 k3s+containerd 两种，用户根据实际需要选择运行环境安装命令，需要注意的是，若用户选择 k3s+docker 运行环境，需先安装 docker 后再安装 k3s。

containerd运行时

docker运行时

运行环境准备就绪后，执行节点安装命令，即可安装边缘节点，效果如下：

采用上述两种模式安装都会在 baetyl-edge-system 部署 baetyl-core, baetyl-init, baetyl-broker 3个服务。查看 baetyl-edge-system 命名空间下的pod均处于运行状态即表示节点安装完成。

删除节点

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

节点卸载

点击上访安装命令，在对应模式在最下面提供了边缘测节点卸载命令

在设备端执行即可卸载相关资源

集群节点

集群类型的节点，适用于边缘测为多台设备联合作为集群统一编排管理的场景。

对集群节点的操作包括创建节点，删除节点，对节点编辑，以及安装节点，查看集群中各子节点信息等。

选择并创建集群类节点并在边缘测安装之后，就可以对集群中的设备进行管控，云端会展示各个集群节点的信息。

现阶段，集群类型的节点安装仅支持在单个主节点的集群下安装使用，且安装命令需要在主节点上执行

集群场景时端侧默认会安装 baetyl-init 、 baetyl-core 、 baetyl-broker 、baetyl-agent 四个模块，其中前三个模块为 deployment 类型，baetyl-agent 为 deamonset 类型。

创建节点

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

集群安装1.png

名称: 节点名称，不可为空，不可重复
描述：描述可以为空
节点类型：如果边缘节点有多台机器，可以将其组成一个k3s/k8s集群，此时使用多机集群类型，这里示例选用集群类型
AI加速卡：支持监控NVIDIA GPU资源使用率，仅限amd64架构的集群
标签：对节点进行标识，用于关联应用，可以不绑定标签，也可以绑定多个标签
认证方式: 节点端云同步使用证书（强制）

集群创建选模块.png

选择官方模块：根据自身需要勾选所需的系统模块，勾选后将创建对应资源并在部署时进行安装。

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

集群创建选模块.png

节点编辑

点击节点进入节点详情页可对节点描述信息进行编辑。

集群详情1.png

在节点信息页可对标签进行编辑，可以添加新的标签，修改已有标签键值，或删除已有标签。

集群详情2.png

在应用部署页可以在应用状态栏查看已关联的应用及应用的标签和子标签信息，在服务状态栏可以查看已部署的服务运行状态，点击编辑按钮可以引入所需的系统模块。

集群信息3.png

在子设备管理页可以引入设备驱动，系统现在默认提供modbus驱动，这部分内容在子设备管理说明页有详细介绍。

集群modbus.png

在节点影子页可以对边缘节点影子进行查看和管理，也可以控制云边同步通道的开启和关闭，这部分内容在节点影子说明页有详细介绍。

集群影子.png

节点安装

集群节点安装目前仅支持 Kube 模式下在线安装和运行。

在 Kube 模式下 baetyl 运行模式包括 k3s+docker 和 k3s+containerd 两种，用户根据实际需要选择运行环境安装命令，需要注意的是，若用户选择 k3s+docker 运行环境，需先安装 docker 后再安装 k3s。

边缘集群这里只提供了 k3s 主节点的安装方式，工作负载节点的安装方式需根据情况自行部署安装。

节点安装-containerd

集群containerd.png

节点安装-docker

集群docker.png

运行环境准备就绪，例如下图所示，由两个节点构成的集群，其中下面的节点为主节点

执行节点安装命令，即可安装边缘节点，效果如下：

安装后会在 baetyl-edge-system 命名空间下部署 baetyl-core, baetyl-init, baetyl-broker, baetyl-agent 4个服务。查看 baetyl-edge-system 命名空间下的pod均处于运行状态即表示节点安装完成。

其中 baetyl-core, baetyl-init 将调度到 master 节点上进行安装，baetyl-broker 会在随机的一个节点上安装，baetyl-agent 会在每一个节点上安装

对多master节点集群的支持

当一个集群当中具有多个master节点，如下图所示：

在这样的集群当中安装边缘节点，必须：

在master节点上执行节点安装指令
必须手动指定当前所在master节点的hostname，如下图所示：

说明：

如果云端创建的节点名称与当前执行命令的主机节点的hostname相同，BIE会跳过用户选择步骤。只有在云端节点名称与当前主机hostname不同时，才需要需要手动进行确认。

BIE默认会使用集群当中各个主机的hostname作为多机集群节点的子节点名称上报到云端。