本文介绍如何在MacOS系统中搭建Link IoT Edge轻量版(LE Lite)运行环境。

前提条件

MacOS设备需要预先配置远程桌面服务,否则无法远程访问。MacOS下SSH服务开启方法如下。
  1. 登录MacOS系统设备。
  2. 打开系统偏好设置 > 共享
  3. 勾选远程登录远程登录

创建边缘实例和网关

  1. 物联网平台控制台,选择边缘计算 > 边缘实例
  2. 创建一个边缘实例。
    1. 单击新增实例,在弹出窗口中设置实例名称
      说明 实例名称支持中文、英文字母大小写、数字、下划线(_)和短划线(-),长度不超过20个字符,1个中文汉字算2个字符。
    2. 网关产品下单击新建网关产品,为实例创建网关。
      物联网边缘计算中的网关承载边缘计算能力,每个实例必须分配一个网关设备,并且该网关设备同一时间只能被分配到一个边缘实例。创建网关产品
    3. 在新建产品页面中,设置网关产品参数,然后单击完成
      物联网边缘计算中的新建网关产品,继承了物联网平台设备管理 > 产品中的产品功能,此处已自动为您简化了创建产品的步骤,以便您更快速地创建适合物联网边缘计算中使用的网关产品。创建产品
      表 1. 参数说明
      参数 说明
      产品名称 为网关产品设置名称,用于后续的查询及识别网关产品。支持中文、英文字母大小写、数字和下划线(_),长度限制4~30,一个中文汉字算2位。
      所属分类

      选择品类,为该产品定义物模型

      可选择的值为:

      • 标准品类:选择任一物联网平台预定义的品类,快速完成产品的功能定义。选择产品模板后,您可以在该模板基础上,编辑、修改、新增功能。
      • 自定义品类:需根据实际需要,定义产品功能。

      若您需要的网关没有特殊功能定义,建议您选择自定义品类

      产品描述 可输入文字,用来描述产品信息。字数限制为100。可以为空。

      产品创建成功后,页面自动跳转回新增实例页面,并且网关产品参数下自动分配了刚创建的网关产品。

    4. 新增实例页面,单击网关设备下的新建网关设备为网关产品添加设备。
      物联网边缘计算中的新建网关设备功能继承物联网平台设备管理 > 设备的功能。新建网关设备
    5. 根据界面提示设置参数后,单击确认
      表 2. 参数说明
      参数 描述
      产品 系统已自动关联上一步创建的网关产品。
      设备名称 为该网关设备命名。设备名称需保持产品内唯一。如不填写,系统将自动生成。
      说明 设备名称长度为4~32个字符,可包含英文字母、数字和特殊字符,包括连接号(-)、下划线(_)、at符号(@)、点号(.)和英文冒号(:)。
    6. 根据所搭建的环境,选择对应的Link IoT Edge产品规格,详细介绍请参见产品规格
    7. (可选)在新增实例页面,单击新增标签,可以设置实例标签。通过标签您可以更加有效地归类及识别实例。您也可以不设置标签。
      若设置实例标签,请填写标签key标签value
      表 3. 参数说明
      参数 描述
      标签key 不可为空,仅支持英文字母大小写,长度不超过20个字符,同一个边缘实例不可以重复定义标签key。
      标签value 不可为空,支持中文、英文字母大小写、数字、下划线(_)和短划线(-),长度不超过20个字符,1个中文汉字算2个字符。
  3. 实例参数设置完成后,单击确定,至此您已创建边缘实例和网关。
  4. 实例详情 > 网关页面,单击网关名称右侧的查看,获取网关设备信息。
    查看网关设备

    系统跳转到网关设备的设备详情页面,在设备详情页面获取网关设备的设备证书(ProductKey、DeviceName、DeviceSecret),用于后续启动Link IoT Edge。

    查看网关设备三元组

安装并启动Link IoT Edge

根据本文上方创建边缘实例和网关内容,创建完成边缘实例并分配网关后,您需要在网关上安装并启动Link IoT Edge。

  1. 登录您MacOS系统的设备。
  2. 打开如下图所示设备本地终端。
    mac本地终端
  3. 下载地址中的轻量版内容下,下载使用环境为MacOS的Link IoT Edge轻量版软件包,保存到设备本地目录。
    例如,下载v1.8.2版本LE Lite软件包到~/Desktop目录,则在本地终端执行如下命令。
    cd ~/Desktop
    ls -alh link-iot-edge-lite-macos-x86-64-v1.8.2.zip
  4. 解压已下载的Link IoT Edge轻量版软件包,可以解压到任意目录。
    例如,将已下载完成的v1.8.2版本LE Lite软件包解压到~/Desktop目录,则执行如下命令。
    tar xopfv link-iot-edge-lite-macos-x86-64-v1.8.2.zip
  5. 启动Link IoT Edge。
    Link IoT Edge启动脚本在软件包/linkedge/gateway/build/script目录下,因此若要启动上述示例中已解压的v1.8.2版本LE Lite,则执行如下命令。
    cd ~/Desktop/linkedge/gateway/build/script
    ./iot_gateway_start_lite.sh {YourProductKey} {YourDeviceName} {YourDeviceSecret}
    说明 请将{YourProductKey} {YourDeviceName} {YourDeviceSecret}替换为已获取的网关设备的设备证书信息。

    例如,网关设备证书信息为ProductKey:a1******gs、DeviceName:gateway、DeviceSecret:2Px**************H1S,则执行的实际命令如下:

    ./iot_gateway_start_lite.sh a1******gs gateway 2Px**************H1S
    若系统显示如下信息,表示Link IoT Edge核心服务启动成功。LE启动成功

    您也可以在物联网平台控制台,左侧导航栏选择边缘计算 > 边缘实例,在已创建好的边缘实例右侧单击查看进入实例详情页面,选择网关,查看网关状态。

    网关在线
  6. (可选)Link IoT Edge支持将边缘实例授权给其他阿里云用户操作。
    边缘实例页面,单击左上角授权,在弹出对话框中单击新增授权,根据界面提示设置参数。实例授权
    表 4. 参数说明
    参数 描述
    授权用户UID 获取被授权用户的阿里云账号ID,填入此处。
    授权实例 选择允许该阿里云账号ID的用户进行远程运维操作的边缘实例。

下一步

  1. 实例详情页面选择设置页签,并在实例信息下,打开远程访问后的按钮。
  2. 实例详情页面选择网关页签,在网关名称右侧的操作栏中单击远程连接远程文件管理或者更多远程服务,远程控制网关设备或对网关设备上的文件进行管理。详细说明请参见远程服务访问