批量节点注册

使用场景

如果您需要对大量相同类型的边缘节点进行管理、更新与维护，这时使用注册边缘节点的方法逐一纳管边缘节点会有些繁琐。

IEF提供批量节点注册功能，使得相同类型的边缘节点能够预安装软件，在上电联网后能自动纳管到IEF中。批量节点注册与边缘节点满足一对多的关系，提高管理效率，也节约了运维成本。

批量节点注册流程

批量纳管边缘节点的流程如下：

1. 准备边缘节点，边缘节点需要满足一定的规格要求，请参见配置边缘节点环境在节点上完成环境配置。
2. 创建批量节点注册作业，获取配置文件和注册软件，并预安装到边缘节点上，具体请参见批量纳管边缘节点。如果在启动脚本配置注册命令，设备上电联网后会自动纳管成为IEF的边缘节点。

创建批量节点注册作业

1. 登录IEF管理控制台，在“总览”页面切换实例为铂金版。
2. 选择左侧导航栏的“批量管理 > 节点注册”，单击页面右上角的“批量节点注册”。
3. 配置基本信息。其中带“*”标志的参数为必填参数。

   

   • 名称：批量节点注册作业的名称。
   • 描述：作业的描述信息。
   • 标签：标签可用于对资源进行标记，方便分类管理。
   • 属性：属性是键值对形式，请输入属性名和属性值。

4. 单击页面右下角的“创建”，节点注册可选“通过证书注册”和“通过token注册”两种方式。
   • 方式一：通过证书注册。下载配置文件、EdgeCore Register和EdgeCore Installer。
     须知：

     为保障节点安全，您现在必须下载配置文件和工具，稍后将无法找回。

     图1 下载配置文件、EdgeCore Register和EdgeCore Installer
     
     1. 根据页面提示，单击“下载cert_1.tar.gz配置文件”下载配置文件。
     2. 根据您边缘节点的CPU架构选择EdgeCore Register和EdgeCore Installer，单击“下载EdgeCore Register”和“下载EdgeCore Installer”。
   • 方式二：通过token注册。下载边缘节点安装工具并保存安装凭证。
     图2 下载边缘核心软件
     
     图3 安装命令
     
     1. 根据您边缘节点的CPU架构选择边缘节点安装工具，单击“下载EdgeCore Installer”。
     2. 保存界面中的安装命令。安装命令有两种执行方式，您可以任选其中的一种方式保存即可。

5. 将下载的文件上传至边缘节点，稍后参见批量纳管边缘节点操作指南纳管边缘节点。

批量纳管边缘节点

按照批量节点注册作业完成页的操作指南，在边缘节点执行纳管操作。

1. 以具备sudo权限的用户登录边缘节点。
2. 执行如下命令解压配置文件、EdgeCore Register和EdgeCore Installer。

   sudo tar -zxvf edge-installer_1.0.10_x86_64.tar.gz -C /opt

   sudo tar -zxvf edge-register_2.0.10_x86_64.tar.gz -C /opt

   sudo tar -zxvf cert_batchNodes.tar.gz -C /opt/edge-register/（“通过token注册”时不需要执行此命令）

   edge-installer_1.0.10_x86_64.tar.gz、edge-register_2.0.10_x86_64.tar.gz和cert_batchNodes.tar.gz请替换为创建批量节点注册作业下载的文件名。

3. （可选）配置节点预置信息文件。

   批量纳管边缘节点会采用默认配置进行节点纳管，其中

   • 节点名称为节点hostname和mac地址的组合“hostname_mac”
   • GPU和NPU默认不启用
   • Docker默认启用

   如需自定义配置节点信息，可以参考以下操作配置节点信息文件。

   cd /opt/edge-register

   vi nodeinfo

   在nodeinfo文件中填入节点的配置信息，其格式如下所示（下面样例罗列了所有可配置的参数，可以根据场景需求配置其中的参数值，对于不需要自定义配置的参数可以删除示例中对应的参数配置）：

   包括节点名称、描述、是否启用GPU、NPU、NPU类型、属性以及日志配置等，具体参数解释请参见API参考 > 注册边缘节点。

   {
       "name": "nodename",
       "description": "",
       "enable_gpu": false,
       "enable_npu": true,
       "npu_type": "***",
       "enable_docker": true,
       "attributes": [
           {
               "key": "key1",
               "value": "value1"
           }
       ],
       "log_configs": [
           {
               "component": "app",
               "type": "local",
               "level": "debug",
               "size": 100,
               "rotate_num": 5,
               "rotate_period": "daily"
           }
       ],
       "device_infos": [
           {
               "device_ids": ["15696983-5ee6-43b4-9653-5d8512813dcc"],
               "relation": "camera",
               "comment": "devicedescription"
           }
       ],
       "mqtt_config": {
           "enable_mqtt": false,
           "mqtts": []
       },
       "tags": [
           {
               "key": "name",
               "value": "value"
           }
       ]
   }

4. 执行如下命令，纳管边缘节点。
   • 通过证书注册

     cd /opt/edge-register; ./register --mode=cert

   • 通过token注册

     cd /opt/edge-register; ./register --mode=identifier --identifier=token注册的凭证

     token注册的凭证请替换为创建批量节点注册作业时保存的安装凭证identifier字段。

   执行完成后，可以根据查看纳管的节点查看节点是否注册成功。

   您也可以配置上电启动脚本，在边缘节点上电时自动执行注册命令，在上电脚本中添加注册命令：cd /opt/edge-register; ./register --mode=cert

   如果注册命令的执行结果返回值为0，则表示注册成功。

查看纳管的节点

批量纳管的节点，可以在控制台查看。

1. 登录IEF管理控制台，在“总览”页面切换实例为铂金版。
2. 选择左侧导航栏的“批量管理 > 节点注册”，在右侧单击作业名称。
3. 在“节点”页签下，可以查看到已经纳管的节点。
   图4 查看批量纳管的节点