本节介绍如何使用Docker镜像搭建边缘环境,配置边缘计算节点。

前提条件

目前支持在以下系统中搭建边缘环境:
  • Windows10 x86_64
  • MAC x86_64
  • Ubuntu 18.04 x86_64
  • Ubuntu 16.04 x86_64
  • Windows10以下操作系统可以先安装ubuntu虚拟机,在虚拟机中安装docker

操作步骤

  1. 安装Docker环境。
    Windows10和Mac环境:
    1. 下载Docker软件,具体请参考Docker官网
    2. 安装Docker,具体安装方法请参考Docker官方文档
    说明 若您的系统为Linux版,请至Docker Store下载安装适配您Linux发行版的Docker客户端。
    Ubuntu环境:
    1. 卸载apt官方库中可能存在的旧版本Docker。
      $ sudo apt-get remove docker docker-engine docker-ce docker.io
    2. 更新apt包索引。
      $ sudo apt-get update
    3. 安装apt通过HTTPS协议使用存储库(repository)所需的工具包。
      $ sudo apt-get install -y apt-transport-https ca-certificates curl software-properties-common
    4. 添加Docker官方的GPG密钥。
      $ curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
    5. 设置stable存储库。
      $ sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"
    6. 再次更新一下apt包索引。
      $ sudo apt-get update
    7. 安装最新版本的Docker CE。
      $ sudo apt-get install -y docker-ce
    8. 查看Docker服务是否启动。
      $ systemctl status docker

      若未启动,则执行如下命令启动Docker服务。

      $ sudo systemctl start docker
    9. 验证Docker是否已经安装成功。
      $ sudo docker run hello-world
      若hello world程序正常运行,则Docker已安装成功。
  2. 下载边缘计算节点启动脚本。
    • Windows或Mac版:curl -O http://aliyun-iotedge.oss-cn-hangzhou.aliyuncs.com/link-iot-edge.sh
    • Linux版:wget http://aliyun-iotedge.oss-cn-hangzhou.aliyuncs.com/link-iot-edge.sh
      说明 如果没有执行下载脚本命令的权限,请执行 $ chmod +x ./link-iot-edge.sh命令授权后,重新执行 wget命令下载Linux版启动脚本。
  3. 启动边缘计算节点,使设备上线。
    ./link-iot-edge.sh {version} {productkey} {devicename} {devicesecret}
    说明
    • 请将{version}替换为需要的Docker镜像版本号,建议您使用最新的版本号。
    • 请将{productkey} {devicename} {devicesecret}替换为实际的网关设备三元组信息。
    • 执行此命令,会删除已存在的Docker容器,创建新的Docker容器,并保存网关三元组信息。
  4. 边缘计算节点成功启动后,您可以在设备管理界面,对应网关设备详情页上,看到设备状态变为在线

  5. (可选)停止边缘计算节点。
    ./link-iot-edge.sh --stop
    说明 执行此命令会终止边缘计算节点的运行,但不会删除Docker容器。若您需要删除Docker容器可以使用 docker rm命令。
  6. (可选)重启边缘计算节点。
    ./link-iot-edge.sh --restart {version}
    说明
    • 请将{version}替换为您的Docker镜像版本号。
    • 如果已执行3中的命令,启动过边缘计算节点,使用此命令可以实现快速重启,并且不再需要配置网关设备三元组信息。
    • 如果边缘计算节点已被删除,使用此命令会重新拉取指定版本的Docker镜像,并启动新的Docker容器。