本文介绍如何在Ubuntu 16.04的系统中搭建Link IoT Edge专业版(LE Pro)的Docker运行环境,实现网关与云端连接的步骤。

专业版(LE Pro)规格的详细说明请参见产品规格

准备工作

LE Pro版需要您提前安装好Docker环境,请参见Docker官方文档安装使用您Ubuntu 16.04系统的Docker客户端。要求Docker版本大于v17.03。

创建边缘实例和网关

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

      可选择为:

      • 自定义品类:需根据实际需要,定义产品功能。
      • 任一既有功能模板。

        选择任一物联网平台预定义的品类,快速完成产品的功能定义。选择产品模板后,您可以在该模板基础上,编辑、修改、新增功能。

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

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

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

    4. 新增实例页面,单击网关设备后的新建网关设备为网关产品添加设备。
      物联网边缘计算中的新建网关设备功能继承物联网平台 设备管理 > 设备的功能。
      新建网关设备
    5. 根据界面提示设置参数后,单击确认
      表 2. 参数说明
      参数 描述
      产品 系统已自动关联上一步创建的网关产品。
      设备名称 为该网关设备命名。设备名称需保持产品内唯一。如不填写,系统将自动生成。
      说明 设备名称支持大写字母[A-Z]、小写字母[a-z]、数字[0-9]和下划线(_)。且不能以下划线开头或结尾。
    6. 根据所搭建的环境,选择对应的Link IoT Edge产品规格,详细介绍请参见产品规格
    7. (可选)在新增实例页面,单击新增标签,可以设置实例标签。通过标签您可以更加有效地归类及识别实例。您也可以不设置标签。
  3. 实例参数设置完成后,单击确定,至此您已创建边缘实例和网关。

启动Link IoT Edge

  1. 在左侧导航栏中选择边缘计算 > 边缘实例,单击实例名称右侧的软件安装

    下载命令
  2. 根据环境设置下载参数,然后单击生成安装命令

    生成专业版linux命令
    表 3. 参数说明
    参数 描述
    CPU架构 您的设备系统对应的CPU架构。此处选择x86-64
    产品规格 在创建边缘实例时,已选择实例中使用的Link IoT Edge版本。此处不可操作。
    边缘版本 选择Link IoT Edge的发布版本
    操作系统 选择您的设备对应的操作系统。此处选择Linux
  3. 复制操作系统命令备用。

    下载专业版linux命令
  4. 登录您的Ubuntu系统机器。
  5. 该命令实现一键下载、
  6. 任意目录下执行步骤3中已复制的命令。
    该命令实现一键下载、配置并启动Link IoT Edge。命令执行完成后,会在当前目录中下载link-iot-edge.sh脚本。
    • 如果第一次启动Link IoT Edge,则需要完成如下交互式配置,您可以直接按Enter键使用默认配置。
      • 确认启动版本
      • 确认函数计算的runtime类型,默认为进程版
      • 确认是否启动流式计算,默认开启流式计算
      • 确认是否卸载之前已安装的版本,默认卸载
      拉取Docker镜像完成并启动可能需要等待5 ~ 10分钟,启动完成后通过docker ps命令查看相关Docker容器是否已启动,若系统显示如下图所示信息,表示启动成功。
      LE启动成功
    • 如果不是第一次安装启动Link IoT Edge,可使用已下载的link-iot-edge.sh脚本,对Link IoT Edge进行重启、停止、获取状态、修改配置参数等操作,命令详情请见下图:
      Link IoT Edge其他操作
  7. 物联网控制台,选择 边缘计算 > 边缘实例,在已创建好的边缘实例右侧单击查看进入实例详情页面,选择网关,查看网关状态。

    网关在线
  8. (可选)在实例详情页面,查看CPU使用率、内存使用率、存储使用率以及实例进程需要授权访问阿里云云监控(CloudMonitor)服务。
    1. 请根据云资源访问内容,添加角色或分配已有的角色,并为该角色添加管理云监控(CloudMonitor)的权限
    2. 选择设置页签,在实例信息中打开云监控状态按钮,如下图所示。

      打开云监控

      云监控状态打开后,可在实例详情页面选择监控信息,查看网关的各类监控信息。

  9. (可选)在实例详情页面选择设置,打开远程访问按钮后,可对网关进行远程管理,详细操作步骤请参见远程服务访问

Link IoT Edge的其它操作

  • 重新配置 Link IoT Edge。

    如果您希望对当前已安装的 Link IoT Edge版本配置进行修改可以使用如下命令:

    ./link-iot-edge.sh --reconfig {Version}

    其中,{Version}替换为目标版本号,例如目标版本号为v1.8.2,则实际命令为./link-iot-edge.sh --reconfig v1.8.2

  • 停止Link IoT Edge。

    使用如下命令可以停止所有Link IoT Edge运行的容器,但是不会删除。

    ./link-iot-edge.sh --stop
  • 重新启动Link IoT Edge。

    在容器已存在且没有运行的状态下,执行如下命令可重新启动Link IoT Edge。

    ./link-iot-edge.sh --restart {Version}

    其中,{Version}替换为目标版本号,例如目标版本号为v1.8.2,则实际命令为./link-iot-edge.sh --restart v1.8.2

  • 清理Link IoT Edge。

    执行如下命令可停止当前运行的Link IoT Edge相关容器 ,并会删除所有已安装的相关镜像,删除相关数据卷以及启动配置文件。

    ./link-iot-edge.sh --clean
  • 提取Link IoT Edge的日志。

    执行如下命令可打包Link IoT Edge的所有日志,并拷贝到当前目录。

    ./link-iot-edge.sh --packagelog

下一步

环境搭建完成后,您可以根据设备接入章节内容,把您的设备接入到物联网边缘计算。同时也可以为边缘实例分配其他资源(如函数计算、消息路由等)管理您的设备。

接入设备或分配其他资源到边缘实例后,需要根据如下步骤部署边缘实例。

  1. 实例详情页面,单击右上角部署后在弹出框中单击确定,部署边缘实例。
  2. 当部署状态显示为部署成功,表示部署实例完成。您可以单击查看日志,查看部署详情。

    查看部署日志