安装或卸载 Azure IoT Edge for Linux

使用 Azure IoT Edge 运行时可将设备转变为 IoT Edge 设备。 该运行时可以部署在像 Raspberry Pi 一样小的设备上,也可以部署在像工业服务器一样大的设备上。 使用 IoT Edge 运行时配置设备后,即可开始从云中部署业务逻辑。 若要了解详细信息,请参阅了解 Azure IoT Edge 运行时及其体系结构

本文列出了在 Linux 设备上安装 Azure IoT Edge 运行时的步骤。

先决条件

  • 已注册的设备 ID

    如果你已为设备注册了对称密钥身份验证,请准备好设备连接字符串。

    如果你已为设备注册了 X.509 自签名证书身份验证,则至少需要有一个用来注册设备的标识证书及其可在设备上使用的匹配私钥。

  • Linux 设备

    具有 X64、ARM32 或 ARM64 Linux 设备。 Azure 提供了适用于 Ubuntu Server 18.04 和 Raspberry Pi OS Stretch 操作系统的安装包。

    有关生产方案目前支持哪些操作系统的最新信息,请参阅 Azure IoT Edge 支持的系统

    注意

    对 ARM64 设备的支持为公共预览版

  • 准备设备以访问 Azure 安装包。

    安装与设备操作系统匹配的存储库配置。

    • Ubuntu Server 18.04

      curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list
      
    • Raspberry Pi OS Stretch

      curl https://packages.microsoft.com/config/debian/stretch/multiarch/prod.list > ./microsoft-prod.list
      

    将生成的列表复制到 sources.list.d 目录。

    sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/
    

    安装 Azure GPG 公钥。

    curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg
    sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/
    

Azure IoT Edge 软件包受制于每个包(usr/share/doc/{package-name}LICENSE 目录)中的许可条款。 请在使用包之前阅读许可条款。 安装和使用包即表示你接受这些条款。 如果不同意许可条款,请勿使用该包。

安装容器引擎

Azure IoT Edge 依赖于 OCI 兼容的容器运行时。 对于生产方案,建议使用 Moby 引擎。 Moby 引擎是官方唯一支持用于 Azure IoT Edge 的容器引擎。 Docker CE/EE 容器映像与 Moby 运行时兼容。

更新设备上的包列表。

sudo apt-get update

安装 Moby 引擎。

sudo apt-get install moby-engine

如果在安装 Moby 容器引擎时出现错误,请验证 Linux 内核的 Moby 兼容性。 有些嵌入式设备制造商寄送的设备映像包含的自定义 Linux 内核没有确保容器引擎兼容所需的功能。 运行以下命令,该命令使用 Moby 提供的 check-config 脚本来检查内核配置:

curl -sSL https://raw.githubusercontent.com/moby/moby/master/contrib/check-config.sh -o check-config.sh
chmod +x check-config.sh
./check-config.sh

在该脚本的输出中,检查 Generally NecessaryNetwork Drivers 下的所有项是否都已启用。 如果缺少某些功能,请启用它们,方法是通过源重新构建内核,然后选择关联的模块,将其包括在相应的内核 .config 中。同样,如果使用内核配置生成器(例如 defconfigmenuconfig),请找到并启用相应的功能,然后以相应方式重新构建内核。 部署新修改的内核以后,请再次运行 check-config 脚本,验证是否已成功启用所有必需功能。

安装 IoT Edge

为设备预配其云标识

现在容器引擎和 IoT Edge 运行时已安装在设备上,你可以开始下一步操作,即,使用设备的云标识和身份验证信息来设置设备。

根据要使用的身份验证类型,选择下一部分:

选项 1:使用对称密钥进行身份验证

此时,IoT Edge 运行时安装在 Linux 设备上,你需要使用设备的云标识和身份验证信息来预配设备。

本部分逐步讲解了如何为设备预配对称密钥身份验证。 你应当已在 IoT 中心注册了设备,并从设备信息中检索了连接字符串。 如果没有,请按照在 IoT 中心注册 IoT Edge 设备中的步骤进行操作。

选项 2:使用 X.509 证书进行身份验证

此时,IoT Edge 运行时安装在 Linux 设备上,你需要使用设备的云标识和身份验证信息来预配设备。

本部分逐步讲解了如何为设备预配 X.509 证书身份验证。 你应当已在 IoT 中心注册了设备,并提供了与 IoT Edge 设备上的证书和私钥相匹配的指纹。 如果没有,请按照在 IoT 中心注册 IoT Edge 设备中的步骤进行操作。

验证成功的配置

验证是否已在 IoT Edge 设备上成功安装并配置运行时。

提示

需要提升权限才能运行 iotedge 命令。 安装 IoT Edge 运行时后从计算机中注销并第一次重新登录后,你的权限将自动更新。 在此之前,请在命令前使用 sudo

检查以确保 IoT Edge 系统服务正在运行。

若需排查服务问题,请检索服务日志。

使用 check 工具验证设备的配置和连接状态。

sudo iotedge check

提示

请始终使用 sudo 来运行检查工具,即使权限已更新。 该工具需要提升的权限才能访问配置文件以验证配置状态。

查看在 IoT Edge 设备上运行的所有模块。 当服务首次启动时,你应当只会看到 edgeAgent 模块正在运行。 edgeAgent 模块会默认运行,用于安装并启动部署到设备的任何其他模块。

sudo iotedge list

创建新的 IoT Edge 设备时,它将在 Azure 门户中显示状态代码 417 -- The device's deployment configuration is not set。 此状态正常,表示设备已准备好接收模块部署。

脱机或特定版本安装(可选)

本部分中的步骤适用于标准安装步骤未涵盖的方案。 这可能包括:

  • 脱机安装 IoT Edge
  • 安装候选发布版本

如果想要安装特定版本的无法通过 apt-get install 获取的 Azure IoT Edge 运行时,请使用本部分中的步骤。 Azure 包列表仅包含有限的一组最新版本及其子版本,因此,这些步骤适用于想要安装较旧版本或候选发布版本的任何用户。

使用 curl 命令,可以直接从 IoT Edge GitHub 存储库将组件文件作为目标。

现在容器引擎和 IoT Edge 运行时已安装在设备上,你可以开始下一步操作,即,使用设备的云标识来预配设备

卸载 IoT Edge

若要从设备中删除 IoT Edge 安装,请使用以下命令。

删除 IoT Edge 运行时。

如果要删除与 IoT Edge 关联的所有文件(包括配置文件),请使用 --purge 标记。 如果要重新安装 IoT Edge 并在以后使用相同的配置信息,请忽略此标记。

删除 IoT Edge 运行时后,已创建的所有容器都会停止,但仍存在于设备上。 查看所有容器以了解哪些容器仍然存在。

sudo docker ps -a

从设备中删除容器,包括两个运行时容器。

sudo docker rm -f <container name>

最后,从设备中删除容器运行时。

sudo apt-get remove --purge moby-cli
sudo apt-get remove --purge moby-engine

后续步骤

转到部署 IoT Edge 模块,了解如何将模块部署到设备上。