进程模式节点

更新时间：2025-08-21

1、功能简介

节点是边缘设备在云端的映射，云端一个节点代表一个边缘系统，边缘系统可以是单机场景下的单台设备，也可以是由多台设备构成的集群。通过在云端创建节点，在边缘设备完成节点安装后，就可以对边缘设备进行管理。此外，还可以在云端查看已有节点，编辑节点信息，删除节点。

节点分为容器模式和进程模式，本章主要介绍进程模式的节点。进程模式针对非容器化运行模式需求设计，主要面向能力差或不支持容器化的工业网关。当节点以进程模式运行时，应用直接在宿主机运行，而不是运行在容器中，程序运行环境和宿主机环境不隔离。

2、进程模式的程序运行环境说明

2.1 工作目录

通过程序运行路径隔离，让不同的程序跑在各自的目录下，从而实现跟容器模式类似的应用隔离的效果。进程模式边缘应用的工作目录格式规范如下：

Plain Text

1/var/lib/baetyl/run/{namespace}/{app-name}/{app-version}/{service-name}/{instance-id}

以baetyl-core为例，对应的一个具体工作目录示例如下：

Plain Text

1/var/lib/baetyl/run/baetyl-edge-system/baetyl-core-uhzm5j2b6/1647231233ubrkqx/baetyl-core/1

2.2 安装目录

2.2.1 Linux操作系统

baetyl程序：/usr/local/bin/baetyl
baetyl配置目录：/var/lib/baetyl/

2.2.2 windows操作系统

baetyl程序：C:\baetyl\bin\baetyl.exe
baetyl配置目录：C:\baetyl\

2.3 配置映射

配置项映射会将配置文件放到程序运行的工作目录下。比如，假定配置项映射为nginx-conf:/etc/nginx，则会把nginx-conf配置项的数据转成文件放置到如下目录当中：

Plain Text

1/var/lib/baetyl/run/{namespace}/{app-name}/{app-version}/{service-name}/{instance-id}/etc/nginx/

针对大文件的处理略有不同，因为大文件在端云同步时就已经下载到宿主机磁盘上，位于/var/lib/baetyl/object/目录下，为了减少文件拷贝和空间占用，对于支持软链接的系统（Windows、Ubuntu、Debain、CentOS等）会采用软链接的方式，不支持的情况下才使用硬拷贝方式。

3、云端

3.1 边缘节点创建

在边缘节点页面切换进程模式后，点击创建节点，进入节点创建页面，完成必要输入后点击下一步。

单机创建1.png

单机创建2.png

单机创建3.png

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

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

3.2 边缘节点删除

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

单机删除节点.png

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

3.3 边缘节点编辑

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

节点详情1.png

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

单机节点详情2.png

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

单机节点详情3.png

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

单机节点详情4.png

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

单机节点详情5.png

4、边缘端

4.1 节点安装

节点安装目前支持 Kube 模式在线安装和进程模式安装在线安装。在节点详情页面点击安装，打开节点安装对话框，切换到进程模式，如下图所示：

安装进程模式需要先安装baetyl程序，复制baetyl程序安装命令在设备上执行。

baetyl程序安装完成后，执行baetyl version可以查看baetyl当前版本后表示baetyl已经成功安装。

然后将进程模式下节点安装命令复制至设备执行

等待一段时间后，在节点详情页可以看到节点已在线，且三个进程应用都已部署

4.2 节点安装目录解析

在执行边缘节点安装命令以后，在边缘节点设备上会创建一个/var/lib/baetyl目录，所有BIE边缘节点相关的内容都放在该目录下，总共包含6大目录，介绍如下：

/var/lib/baetyl/init/store/core.db：baetyl-init模块本地kv存储文件
/var/lib/baetyl/store/core.db：baetyl-core模块本地kv存储文件
/var/lib/baetyl/object: 大文件下载存储目录
/var/lib/baetyl/host：其他文件
/var/lib/baetyl/run：程序运行目录，程序工作目录就位于改目录下。
/var/lib/baetyl/log：日志文件目录

一个边缘节点初始安装以后的目录结构及文件示例如下：

Plain Text

1root@edge-node:/var/lib/baetyl# tree
2.
3├── host
4├── init
5│   └── store
6│       └── core.db
7├── log
8│   └── baetyl-edge-system
9│       ├── baetyl-broker-fvpjgyphg
10│       │   └── 1647231233e6me8h
11│       │       └── baetyl-broker-1.log
12│       ├── baetyl-core-uhzm5j2b6
13│       │   └── 1647231233ubrkqx
14│       │       └── baetyl-core-1.log
15│       └── baetyl-init-miqqgm8y3
16│           └── 1647231233izeku3
17│               └── baetyl-init-1.log
18├── object
19│   ├── baetyl-program-config-baetyl-broker-q5qfjmhrq
20│   │   └── 1647231231gn9g6z
21│   │       ├── baetyl-broker
22│   │       ├── baetyl-broker_linux-arm64-v8.zip
23│   │       └── program.yml
24│   ├── baetyl-program-config-baetyl-core-wd8pgwqcw
25│   │   └── 1647231231iatdab
26│   │       ├── baetyl
27│   │       ├── baetyl_linux-arm64-v8.zip
28│   │       └── program.yml
29│   └── baetyl-program-config-baetyl-init-pgjmmbxgs
30│       └── 1647231231mjxcmv
31│           ├── baetyl
32│           ├── baetyl_linux-arm64-v8.zip
33│           └── program.yml
34├── run
35│   ├── baetyl-edge-system
36│   │   ├── baetyl-broker-fvpjgyphg
37│   │   │   └── 1647231233e6me8h
38│   │   │       └── baetyl-broker
39│   │   │           └── 1
40│   │   │               ├── etc
41│   │   │               │   └── baetyl
42│   │   │               │       └── conf.yml
43│   │   │               ├── service.yml
44│   │   │               └── var
45│   │   │                   └── lib
46│   │   │                       └── baetyl
47│   │   │                           ├── bin -> /var/lib/baetyl/object/baetyl-program-config-baetyl-broker-q5qfjmhrq/1647231231gn9g6z
48│   │   │                           ├── broker.db
49│   │   │                           ├── run -> /var/lib/baetyl/run
50│   │   │                           └── system
51│   │   │                               └── certs
52│   │   │                                   ├── ca.pem
53│   │   │                                   ├── crt.pem
54│   │   │                                   └── key.pem
55│   │   ├── baetyl-core-uhzm5j2b6
56│   │   │   └── 1647231233ubrkqx
57│   │   │       └── baetyl-core
58│   │   │           └── 1
59│   │   │               ├── etc
60│   │   │               │   └── baetyl
61│   │   │               │       └── conf.yml
62│   │   │               ├── service.yml
63│   │   │               └── var
64│   │   │                   └── lib
65│   │   │                       └── baetyl
66│   │   │                           ├── bin -> /var/lib/baetyl/object/baetyl-program-config-baetyl-core-wd8pgwqcw/1647231231iatdab
67│   │   │                           ├── host -> /var/lib/baetyl/host
68│   │   │                           ├── node
69│   │   │                           │   ├── ca.pem
70│   │   │                           │   ├── client.key
71│   │   │                           │   └── client.pem
72│   │   │                           ├── object -> /var/lib/baetyl/object
73│   │   │                           ├── run -> /var/lib/baetyl/run
74│   │   │                           ├── store -> /var/lib/baetyl/store
75│   │   │                           └── system
76│   │   │                               └── certs
77│   │   │                                   ├── ca.pem
78│   │   │                                   ├── crt.pem
79│   │   │                                   └── key.pem
80│   │   └── baetyl-init-miqqgm8y3
81│   │       └── 1647231233izeku3
82│   │           └── baetyl-init
83│   │               └── 1
84│   │                   ├── etc
85│   │                   │   └── baetyl
86│   │                   │       └── conf.yml
87│   │                   ├── service.yml
88│   │                   └── var
89│   │                       └── lib
90│   │                           └── baetyl
91│   │                               ├── bin -> /var/lib/baetyl/object/baetyl-program-config-baetyl-init-pgjmmbxgs/1647231231mjxcmv
92│   │                               ├── core
93│   │                               │   └── store -> /var/lib/baetyl/store
94│   │                               ├── host -> /var/lib/baetyl/host
95│   │                               ├── node
96│   │                               │   ├── ca.pem
97│   │                               │   ├── client.key
98│   │                               │   └── client.pem
99│   │                               ├── object -> /var/lib/baetyl/object
100│   │                               ├── run
101│   │                               │   └── services.yml
102│   │                               ├── store -> /var/lib/baetyl/init/store
103│   │                               └── system
104│   │                                   └── certs
105│   │                                       ├── ca.pem
106│   │                                       ├── crt.pem
107│   │                                       └── key.pem
108│   └── services.yml
109└── store
110    └── core.db

4.3 节点日志查看

进程模式下，边缘应用的日志在 /var/lib/baetyl/log 目录下，且针对系统应用和用户应用进行区分。

系统应用日志在 /var/lib/baetyl/log/baetyl-edge-system 路径下
用户应用在 /var/lib/baetyl/log/baetyl-edge 路径下

由于这些路径使用root权限创建，如以普通用户身份查看时需要更改owner，才能进入这些路径查看日志。执行修改目录权限命令：

Plain Text

1sudo chown -R $(id -u):$(id -g) /var/lib/baetyl

然后进入需要查看日志应用对应路径。以系统应用baetyl-broker为例，进入/var/lib/baetyl/log/baetyl-edge-system/baetyl/baetyl-broker-erqilkypt/1625131937uibjgq 目录，最后一层目录的名字后缀是随机生成，以实际后缀为准。

路径下的baetyl-broker-1.log文件即为日志，其它应用日志查看步骤类似。

4.4 节点卸载

在节点安装模式，切换到进程模式，复制节点卸载命令在设备上执行

一段时间后，在节点详情页显示节点已离线

4.5 边缘服务管理

BIE进程模式的边缘应用都以服务形式启停，托管给systemd来管理，可以使用systemctl命令来管理BIE边缘应用。

4.5.1 查看BIE正在运行的服务清单

使用systemctl | grep baetyl命令查看BIE边缘服务

Bash

1systemctl | grep baetyl
2  baetyl-edge-system.baetyl-broker-6tg6gj9lm.1668757408widb8u.baetyl-broker.1.service                                                           loaded active     running      baetyl-edge-system.baetyl-broker-6tg6gj9lm.1668757408widb8u.baetyl-broker.1.service
3  baetyl-edge-system.baetyl-core-zchtp7kaj.1668757407ptm8dh.baetyl-core.1.service                                                               loaded active     running      baetyl-edge-system.baetyl-core-zchtp7kaj.1668757407ptm8dh.baetyl-core.1.service
4  baetyl-edge-system.baetyl-init-jmlxp4h8a.1668757407vs9hg3.baetyl-init.1.service                                                               loaded active     running      baetyl-edge-system.baetyl-init-jmlxp4h8a.1668757407vs9hg3.baetyl-init.1.service
5  baetyl-edge.bacnet-cu-driver-application-nss9qesmb.1669703281jgsaqc.bacnet-custom-1-baetyl-driver.1.service                                   loaded active     running      baetyl-edge.bacnet-cu-driver-application-nss9qesmb.1669703281jgsaqc.bacnet-custom-1-baetyl-driver.1.service

4.5.2 查看服务状态

使用systemctl status命令查看BIE边缘服务

                Bash
                
            

                systemctl status baetyl-edge-system.baetyl-core-vuyraqchw.1669338418dtixrg.baetyl-core.1.service
● baetyl-edge-system.baetyl-core-vuyraqchw.1669338418dtixrg.baetyl-core.1.service
   Loaded: loaded (/etc/systemd/system/baetyl-edge-system.baetyl-core-vuyraqchw.1669338418dtixrg.baetyl-core.1.service; enabled; vendor preset: enabled)
   Active: active (running) since Thu 2022-12-01 18:13:22 +08; 6min ago
 Main PID: 27113 (baetyl)
    Tasks: 24 (limit: 4915)
   CGroup: /system.slice/baetyl-edge-system.baetyl-core-vuyraqchw.1669338418dtixrg.baetyl-core.1.service
           ├─27113 /media/dumu/usr/baetyl/object/baetyl-program-config-baetyl-init-hrshrp53b/166933841856w2jq/baetyl program /var/lib/baetyl/run/baetyl-edge-system/baetyl-core-vuyraqchw/1669338418dtixrg/baetyl-core/1
           └─27179 /var/lib/baetyl/run/baetyl-edge-system/baetyl-core-vuyraqchw/1669338418dtixrg/baetyl-core/1/var/lib/baetyl/bin/baetyl core
            

4.5.3 启停服务

使用systemctl restart|stop|start命令启停服务

                Bash
                
            

                cd /etc/systemd/system/
# 查看baetyl服务
ls -l baetyl*
-rw-r--r-- 1 root root 708 11月 30 15:56 baetyl-edge-system.baetyl-broker-pjldzbhld.1669338418ax8khn.baetyl-broker.1.service
-rw-r--r-- 1 root root 696 11月 30 15:56 baetyl-edge-system.baetyl-core-vuyraqchw.1669338418dtixrg.baetyl-core.1.service
-rw-r--r-- 1 root root 690 11月 30 15:57 baetyl-edge-system.baetyl-dmp-zh6catanp.1669794847tajtpd.baetyl-dmp.1.service
-rw-r--r-- 1 root root 544 11月 30 15:55 baetyl-edge-system.baetyl-init-ykitkkph9.1669338418qvx4cq.baetyl-init.1.service
# 停止baetyl-core
systemctl stop baetyl-edge-system.baetyl-core-vuyraqchw.1669338418dtixrg.baetyl-core.1.service
# 重启baetyl-core
systemctl restart baetyl-edge-system.baetyl-core-vuyraqchw.1669338418dtixrg.baetyl-core.1.service
# 启动baetyl-core
systemctl start baetyl-edge-system.baetyl-core-vuyraqchw.1669338418dtixrg.baetyl-core.1.service
            

边缘应用获取云端STS鉴权

远程MQTT消息下发

智能边缘 BIE

智能边缘 BIE

进程模式节点

1、功能简介

2、进程模式的程序运行环境说明

2.1 工作目录

2.2 安装目录

2.2.1 Linux操作系统

2.2.2 windows操作系统

2.3 配置映射

3、云端

3.1 边缘节点创建

3.2 边缘节点删除

3.3 边缘节点编辑

4、边缘端

4.1 节点安装

4.2 节点安装目录解析

4.3 节点日志查看

4.4 节点卸载

4.5 边缘服务管理

4.5.1 查看BIE正在运行的服务清单

4.5.2 查看服务状态

4.5.3 启停服务