更新时间:2023-11-23 GMT+08:00

批量节点注册

使用场景

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

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.gzedge-register_2.0.10_x86_64.tar.gzcert_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 查看批量纳管的节点