通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

在 IoT Central 应用程序中管理 IoT Edge 部署清单

通过部署清单，可以指定 IoT Edge 运行时应下载和配置的模块。 IoT Edge 设备首次连接到 IoT Central 应用程序时，可以下载部署清单。 本文介绍如何在 IoT Central 应用程序中管理部署清单。

若要了解有关 IoT Edge 和 IoT Central 的详细信息，请参阅 将 Azure IoT Edge 设备连接到 Azure IoT Central 应用程序。

若要了解如何使用 IoT Central REST API 管理部署清单，请参阅 如何使用 IoT Central REST API 管理部署清单。

管理部署清单

使用 Edge 清单 页可以管理应用程序中的部署清单。 在此页中，可以：

  • 上传或创建部署清单
  • 修改现有部署清单
  • 删除部署清单

上传和创建部署清单

创建新的部署清单时，可以上传部署清单 JSON 文件，也可以从现有清单开始：

  1. 在“Edge 清单文件”页上，选择“+ 新建”。

  2. 输入部署清单的名称。

  3. 如果您的应用程序使用组织，请选择一个组织以将部署清单与之关联。

  4. 浏览要上传的部署清单文件，或选择现有部署清单作为新部署清单的起点。 IoT Central 会验证任何上传的文件。

    显示上传和验证的部署清单的屏幕截图。

  5. 选择“下一步”。 “ 查看和完成 ”页显示有关部署清单及其定义的模块的信息。 还可以查看原始 JSON。

  6. 选择 创建。 Edge 清单页现在包含新的部署清单。

小窍门

如果你有大量部署清单，则可以对 Edge 清单 页上显示的列表进行排序和筛选。

编辑部署清单的 JSON 源

若要通过直接编辑 JSON 来修改部署清单，请执行以下作：

  1. 导航到 Edge manifest 页面。

  2. 在要修改的部署清单的上下文菜单中选择 “编辑 JSON ”。

  3. 使用 JSON 编辑器进行所需的更改。 然后，选择“保存”。

替换部署清单的内容

若要完全替换部署清单的内容，请执行以下步骤：

  1. 导航到“Edge 清单”页。

  2. 选择要替换的部署清单。

  3. 在自定义对话框中，寻找要上传的新部署清单文件或选择现有部署清单作为起点。 IoT Central 会验证任何上传的文件。

  4. 选择“下一步”。 “ 查看和完成 ”页显示有关新部署清单及其定义的模块的信息。 还可以查看原始 JSON。

  5. 选择“保存”。 Edge 清单页现在包括更新的部署清单。

管理 IoT Edge 设备

在设备页上添加 IoT Edge 设备时，可以为设备选择部署清单。 在“ 创建新设备 ”对话框中，可以从 Edge 清单 页上以前上传的设备清单列表中进行选择。 创建设备后，还可以将部署清单直接添加到设备。

如果添加未分配给设备模板的 IoT Edge 设备，“ 创建新设备 ”对话框将如以下屏幕截图所示：

显示向应用程序添加未分配设备的屏幕截图。

若要为设备选择部署清单，请执行以下步骤：

  1. 将 Azure IoT Edge 设备 切换为 “是”。

  2. 选择要使用的 IoT Edge 部署清单。 还可以选择在创建设备后分配部署清单。

  3. 选择 创建。

如果添加分配给设备模板的 IoT Edge 设备，“ 创建新设备 ”对话框将如以下屏幕截图所示：

显示向应用程序添加已分配设备的屏幕截图。

若要为设备选择部署清单，请执行以下步骤：

  1. Azure IoT Edge 设备？切换已设置为“是”，因为 IoT Central 可识别你正在使用 IoT Edge 设备模板。

  2. 选择要使用的 IoT Edge 部署清单。 还可以选择在创建设备后分配部署清单。

  3. 选择 创建。

当 IoT Edge 设备首次连接到应用程序时，它会下载部署清单，配置部署清单中指定的模块，并运行模块。

如果您在创建 IoT Edge 设备时未选择部署清单，您可以稍后通过作业单独分配一个给某个设备，或者将其分配给多个设备。

更新设备所使用的部署清单

可以管理现有设备的部署清单：

显示用于管理设备上的部署清单的选项的屏幕截图。

使用 指派边缘清单 从 边缘清单页面 中选择以前上传的部署清单。 如果修改 Edge 清单 页上的部署清单，还可以使用此选项手动通知设备。

使用 “编辑清单” 修改此设备的部署清单。 此处所做的更改不会影响 Edge 清单 页上的部署清单。

Jobs

若要为多个设备分配或更新部署清单，请使用 作业。 使用 更改边缘部署清单 的作业类型：

显示部署清单作业类型的屏幕截图。

将模块和属性添加到设备模板

部署清单定义要在设备上运行的模块，以及可用于配置模块 的可选可写属性 。

如果要将设备模板分配给 IoT Edge 设备，可能需要在设备模板中定义模块和可写属性。 将模块和属性定义添加到设备模板：

  1. 导航到 IoT Edge 设备模板的“ 模块摘要 ”页。
  2. 从清单中选择“导入模块”。
  3. 从列表中选择相应的部署清单。
  4. 选择“导入” 。 IoT Central 将部署清单中定义的自定义模块添加到设备模板。 设备模板中模块的名称与部署清单中的自定义模块的名称匹配。 生成的接口包括部署清单中为自定义模块定义的属性的属性定义：

显示将模块定义导入到设备模板的屏幕截图。