通过 Azure 门户部署 Azure IoT Edge 模块

适用于:“是”图标 IoT Edge 1.1 “是”图标 IoT Edge 1.2

使用业务逻辑创建 IoT Edge 模块后,需要将其部署到设备后才能在边缘操作。 如果多个模块共同协作来收集和处理数据,可同时部署它们并声明用于连接它们的路由规则。

本文介绍了 Azure 门户如何引导创建部署清单并将部署推送给 IoT Edge 设备。 有关基于多个设备的共享标签创建针对这些设备的部署的信息,请参阅大规模地部署和监视 IoT Edge 模块

先决条件

配置部署清单

部署清单是一个 JSON 文档,其中描述了要部署的模块、数据在模块间的流动方式以及模块孪生的所需属性。 若要详细了解部署清单的工作原理及创建方式,请参阅了解如何使用、配置和重用 IoT Edge 模块

Azure 门户提供部署清单的创建向导,无需你手动构建 JSON 文档。 它分为三步:添加模块、指定路由和评审部署 。

备注

本文中的步骤反映了 IoT Edge 代理和中心的最新架构版本。 架构版本 1.1 随 IoT Edge 版本 1.0.10 一起发布,支持模块启动顺序和路由优先级功能。

如果要部署到运行 1.0.9 或更早版本的设备,请在向导的“模块”步骤中编辑“运行时设置”,以使用架构版本 1.0 。

选择设备并添加模块

  1. 登录 Azure 门户,导航到 IoT 中心。

  2. 在左窗格的菜单中,选择“IoT Edge”。

  3. 在设备列表中单击目标设备的 ID。

  4. 在上方栏中,选择“设置模块”。

  5. 在此页的“容器注册表设置”部分,提供用于访问包含模块映像的任何专用容器注册表的凭据。

  6. 在此页的“IoT Edge 模块”部分,选择“添加” 。

  7. 从下拉菜单中选择以下三种模块中的一种:

    • IoT Edge 模块 - 提供模块名称和容器映像 URI。 例如,示例 SimulatedTemperatureSensor 模块的映像 URI 为 mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.0。 如果模块映像存储在专用容器注册表中,则在此页面上添加凭据来访问该映像。
    • 市场模块 - Azure 市场中托管的模块。 某些市场模块需要其他配置,因此请查看 Azure 市场 IoT Edge 模块列表中的模块详细信息。
    • Azure 流分析模块 - 通过 Azure 流分析工作负载生成的模块。
  8. 添加模块后,从列表中选择模块名称以打开模块设置。 必要时请填写可选字段。

    有关可用模块设置的详细信息,请参阅模块配置和管理

    要详细了解模块孪生,请参阅定义或更新所需属性

  9. 重复步骤 6-8,向部署中添加其他模块。

  10. 在完成时选择“下一步:路由”继续转到路由部分。

指定路由

在“路由”选项卡中,定义消息在模块和 IoT 中心之间传递的方式。 使用名称/值对构造消息。 默认情况下,新设备的第一个部署包括名为 route 并定义为 FROM /messages/* INTO $upstream 的路由,这意味着任何模块输出的任何消息输出都将发送到 IoT 中心 。

“优先级”和“生存时间”是可选参数,你可在路由定义中包含这些参数 。 通过优先级参数,你可选择哪些路由的消息应该首先处理,或哪些路由应该最后处理。 优先级通过设置数字 0-9 来确定,其中 0 为最高优先级。 通过生存时间参数,你可声明该路由中的消息在被处理或从队列中删除之前应保留多长时间。

有关如何创建路由的详细信息,请参阅声明路由

设置路由后,选择“下一步: 查看 + 创建”以继续执行向导的下一步。

评审部署

评审部分介绍了根据上述两部分中的选择所创建的 JSON 部署清单。 请注意,$edgeAgent 和 $edgeHub 模块已声明但却未添加 。 这两个模块构成 IoT Edge 运行时,且是每个部署中所需的默认设置。

查看部署信息,然后选择“创建”。

查看设备上的模块

将模块部署到设备之后,即可在 IoT 中心的设备详细信息页中查看所有模块。 此页面显示每个已部署模块的名称,以及部署状态和退出代码等有用信息。

从 Azure 市场部署模块

Azure 市场是一个在线应用程序和服务市场,可在其中浏览各种企业级应用程序和解决方案,这些应用程序和解决方案进行了认证和优化以在 Azure 上运行,包括 IoT Edge 模块

可以从 Azure 市场和 IoT 中心部署 IoT Edge 模块。

从 Azure 市场部署

详细考察市场中的 IoT Edge 模块,找到所需的模块后,可以通过选择“创建”或“立即获取”来部署它 。 继续执行部署向导步骤,这些步骤可能会因所选的 IoT Edge 模块而异:

  1. 通过选择“继续”,承认提供商的使用条款和隐私政策。 你可能首先需要提供联系信息。
  2. 选择你的订阅和要将目标设备附加到的 IoT 中心。
  3. 选择“部署到设备”。
  4. 输入设备的名称,或选择“查找设备”以浏览注册到中心的设备。
  5. 选择“创建”以继续配置部署清单的标准过程,包括根据需要添加其他模块。 新模块的详细信息(例如映像 URI、创建选项以及所需的属性)已预定义,但可以更改。

验证该模块是否已部署在 Azure 门户的 IoT 中心。 选择设备,选择”设置模块“,该模块应列在“IoT Edge 模块”部分中 。

从 Azure IoT 中心部署

可以将 Azure 市场中的模块快速部署到 Azure 门户的 IoT 中心的设备上。

  1. 在 Azure 门户中,导航到 IoT 中心。
  2. 在左窗格的“自动设备管理”下,选择“IoT Edge” 。
  3. 选择要接收部署的 IoT Edge 设备。
  4. 在上方栏中,选择“设置模块”。
  5. 在“IoT Edge 模块”部分中,单击“添加”,然后从下拉菜单中选择“市场模块”。

在 IoT 中心添加模块

从“IoT Edge 模块市场”页面选择一个模块。 系统会自动为你的订阅、资源组和设备配置所选的模块。 然后,所选模块将显示在 IoT Edge 模块列表中。 某些模块可能需要其他配置。

提示

Azure IoT 中心提供的有关 IoT Edge 模块的信息是有限的。 你可以先在 Azure 市场中了解有关 IoT Edge 模块的详细信息。

在完成时选择“下一步:路由”,并按本文前面的指定路由查看部署所述继续进行部署。

后续步骤

了解如何大规模地部署和监视 IoT Edge 模块