文档首页> 智能边缘平台 IEF> 用户指南> 专业版操作指南> 批量管理> 批量节点注册
更新时间：2023-11-23 GMT+08:00
查看PDF

批量节点注册

使用场景

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

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

批量节点注册流程

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

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

创建批量节点注册作业

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

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

  4. 单击页面右下角的“创建”，节点注册可选“通过证书注册”和“通过token注册”两种方式。

    • 方式一：通过证书注册。下载配置文件、EdgeCore Register和EdgeCore Installer。

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

      1. 根据页面提示，单击“下载cert_1.tar.gz配置文件”下载配置文件。
      2. 根据您边缘节点的CPU架构选择EdgeCore Register和EdgeCore Installer，单击“下载EdgeCore Register”和“下载EdgeCore Installer”。
    • 方式二：通过token注册。下载EdgeCore Register和EdgeCore Installer，并保存安装凭证。
      图1 下载EdgeCore Register和EdgeCore Installer
      图2 安装凭证
      1. 根据您边缘节点的CPU架构选择EdgeCore Register和EdgeCore Installer，单击“下载 EdgeCore Register”和“下载EdgeCore Installer”。
      2. 保存执行安装命令中的identifier字段。

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

批量纳管边缘节点

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

  1. 以具备sudo权限的用户登录边缘节点。
  2. 上传创建批量节点注册作业：步骤4下载好的配置文件和工具到边缘节点。
  3. 执行如下命令解压配置文件、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请替换为创建批量节点注册作业下载的文件名。

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

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

    • 节点名称为节点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"
        }
    ]
}

  5. 执行如下命令，纳管边缘节点。

    • 通过证书注册

      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. 在“节点”页签下，可以查看到已经纳管的节点。

    图3 查看批量纳管的节点

父主题： 批量管理