节点预配

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命令查看部署状态：

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

1echo "record123" > /var/lib/baetyl/sn/fingerprint.txt
2cat /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命令查看模块运行情况：

因为本次采用的是【手动输入】的激活方式，所以需要在浏览器访问：http://127.0.0.1:30007 页面来进行激活：

在【SerialNumber】对应的输入框输入注册的设备指纹，在【Description】对应的框中可以选择性的输入描述信息(可选)，然后点击【激活】即可。

显示“激活成功”则表示已经激活完毕，可以通过如下命令，查看模块部署启动情况：

最终可以看到baetyl-core模块正常运行。

在云端可以查看激活情况，点击蓝色的节点名称或者在边缘节点页面可以查看节点详情，至此在开启白名单的情况下节点注册激活完毕。

3.3 其他激活方式说明

在【创建产品】的弹窗页面，您还可以选择系统Hostname、系统BootID、系统SystemUUID、系统MachineID的作为设备指纹获取方式。

设备指纹对应产品注册记录中的注册ID。

其中，系统Hostname可以在边缘设备上通过如下方式查看：

这里master角色下的node的NAME即为激活时采集的hostname。

其中，系统BootID、系统SystemUUID、系统MachineID的可以通过如下方式进行查看：

当在边缘设备执行在线安装命令后，模块即会自动采集对应信息进行激活。