节点预配

更新时间：2023-03-28

1、功能简介

节点预配主要面向边缘设备批量注册激活的场景。您可以通过创建产品批次，然后在此产品下通过多种方式注册和激活一批边缘节点。同一产品批次的激活的节点具有相同的标签，方便您后续对这些节点进行操作管理。

2、设计说明

在实际的边缘部署场景中，我们经常会有批量对设备进行注册、激活和管理的需求。节点预配功能即提供了产品批次的创建和管理、设备注册的管理及生成初始化部署命令的能力。

主要操作流程如下：
1. 创建产品批次
2. 注册和管理设备指纹
3. 在设备端部署安装
4. 在云端查看激活状态和激活节点详情
节点注册记录状态：
- 未激活
- 已激活
节点注册记录状态判断逻辑：
- 用户在端上执行安装命令后，若云端未获得设备指纹，状态仍然是未激活。
- 当端上设备指纹和云端注册列表的指纹比对成功（开启白名单），或设备指纹成功注册到注册记录列表时（未开启白名单），节点注册记录激活成功，此时云端会自动触发创建节点操作，并将云端节点证书返回给边缘侧，云边通道建立以后，云端接受边缘节点上报信息。

3、使用流程

点击节点预配，点击创建产品按钮进入产品的创建界面：

【名称】表示创建的产品（批次）名字
【白名单】表示是否要进行设备指纹的预注册。
- 在白名单开关打开的情况下，您需要在后续的产品详情页预先录入要激活设备的设备指纹，当设备尝试激活时，会对激活设备提供的指纹进行对比，判断是否在预注册列表中，只有在列表中的设备才能激活；
- 在白名单开关关闭的情况下，您无需在产品详情页预录入设备指纹，当设备尝试激活时，云端会自动把设备提交的设备指纹注册到注册记录列表当中，并触发激活创建边缘节点；
【激活方式】表示设备端激活通过何种方式采集设备指纹提交进行激活。目前支持的模式有：
- 手动设置指纹
  - SN文件：选择SN文件，会需要您指定【SN文件路径及名称】，默认路径为 /var/lib/baetyl/sn/fingerprint.txt。
  - 手动输入：选择手动输入，会需要您指定Web页面采集【字段名称】，默认为 sn。
- 系统采集指纹
  - 系统Hostname：边缘程序自动采集
  - 系统BootID：边缘程序自动采集
  - 系统SystemUUID：边缘程序自动采集
  - 系统MachineID：边缘程序自动采集
【节点类型】激活的节点是单机节点还是集群节点
【AI加速卡】激活的节点机器上的AI加速卡类型，根据实际情况选择，默认无
【添加官方应用】可选的边缘节点可选系统应用，可根据需要添加，目前支持如下系统应用：
- baetyl-rule
- baetyl-function
- baetyl-accelerator-metrics
- baetyl-opcua-simulator
- baetyl-ipc-simulator
- baetyl-modbus-rtu-simulator
- baetyl-modbus-tcp-simulator
【最大注册记录】最大的注册记录数
【描述】表示对此产品的文字性描述

因为产品的创建和激活有多种选项组合，后面会分别以【未开启白名单通过文件激活的方式】和【开启白名单通过手动激活的方式】进行流程介绍：

3.1 未开启白名单通过文件激活的方式

点击【创建产品】按钮：

选择关闭【白名单】，选取SN文件作为【激活方式】（需用户在指定目录下创建文件并添加文件内容），采用默认的【SN文件路径及名称】或自己指定SN文件存放位置 ([注意] Mac系统下SN文件必须放在用户目录下，而不能放在系统目录下)。

点击确定创建产品，点击产品名称或【查看】可以进入产品详情页，点击【删除】可以删除没有注册记录的产品。
点击【获取安装方式】，复制在线安装命令，在设备的终端上执行之前复制的在线安装命令，会显示类似安装过程：

需要提前在边缘节点上安装好k3s环境，容器运行时可以使用docker或者containerd。

待命令安装完成后，因为没有测试设备没有指纹信息，所以此时激活不成功，可以通过kubectl get pod -n baetyl-edge-system命令查看部署状态：

在边缘节点当中写入测试指纹，并查看，如图所示：

echo "record123" > /var/lib/baetyl/sn/fingerprint.txt
cat /var/lib/baetyl/sn/fingerprint.txt

在写入指纹以后，再次执行kubectl get pod -n baetyl-edge-system查看部署状态：

说明：如果设备正常激活，则最终会看到系统模块【baetyl-core】模块启动运行

此时可以在云端产品详情页看到设备注册激活的情况，在【边缘节点】列表中也可以找到对应节点，可以点击查看节点详情，可以看到节点已经正常注册激活并开始了进行信息上报，至此注册激活完成。

3.2 开启白名单通过手动激活的方式

点击【创建产品】按钮：

选择开启【白名单】，选取手动输入作为【激活方式】，采用默认的【字段名称】。

点击确定创建产品，点击产品名称或【查看】可以进入产品详情页

因为此产品开启了白名单验证，所以我们需要先添加设备指纹注册记录。这里提供单条添加和系统批量添加的方式，下面逐一进行介绍：

a.单条手动添加

点击【添加注册记录】，可以选择注册ID由系统自动生成的方式进行添加，此时可以选择指定节点名称，若不指定则后续会使用注册ID作为节点名称，也可以选择手动录入作为注册ID的设备指纹。

b.批量添加

点击【批量添加】按钮，可自动生成指定数量的记录，即可由系统添加指定条注册记录。

也可以通过文件批量导入的方式添加一定数量的记录，首先下载csv模板文件到本地，在文件中添加需要添加注册的记录名，如下所示：

添加完后上传该csv文件即可。

其他操作
- 可以在激活前通过点击注册记录右侧的【编辑】按钮来修改节点名称
- 可以在激活前通过点击注册记录右侧的【删除】按钮来删除注册记录
- 点击如图所示的下载按钮，可以下载已有注册记录信息，方便您后续的批量操作
添加完注册记录了以后就可以通过点击产品名称右侧的【获取安装方式】按钮来获取在线安装命令，在设备的终端上执行之前复制的在线安装命令，会显示类似安装过程：

安装后可以通过kubectl get pod -n baetyl-edge-system命令查看模块运行情况：