通过

创建部署

  • 项目

重要

这是 Azure Sphere（旧版）文档。 Azure Sphere（旧版）将于 2027 年 9 月 27 日停用，用户此时必须迁移到 Azure Sphere（集成）。 使用位于 TOC 上方的版本选择器查看 Azure Sphere（集成）文档。

若要从云部署应用程序，请将应用程序映像上传到 Azure Sphere 租户，并创建部署以将映像分发给 Azure Sphere 设备。 若要创建部署，你必须登录到 Azure Sphere 并且必须具有管理员角色。 此外，你的设备还必须准备好接收云部署。

注意

部署中的每个组件都必须有唯一的 GUID。 如果让应用程序基于 Azure Sphere 示例，请记住在创建部署之前为应用程序创建唯一的 GUID，避免可能出现的冲突。

准备设备

在你的设备能够从云接收应用程序之前，它们必须具有产品并属于设备组，且不能安装 AppDevelopment 功能。

如果尚未为设备创建产品，则需要执行此操作，然后才能创建部署。 创建产品：

azsphere product create --name <product-name>

将产品名称>替换为<产品的名称，例如 DW100。 有关此命令的详细信息，请参阅 azsphere 产品。

部署目标设备组，因此你还需将设备分配给设备组（该设备组会启用云更新），然后才能接收部署的应用程序。 默认情况下，每个产品都有五个设备组：生产、现场测试、开发、现场测试 OS 评估和生产 OS 评估。 你可以使用其中一个设备组，或创建自己的设备组。 若要确定某一设备组是否支持应用程序更新，请使用 azsphere device-group show。

设备还必须准备好进行云加载，这意味着它们没有 appDevelopment 功能。 出厂时，设备不具备此功能。 但是，如果你已使用设备进行应用程序开发，则你可能已通过 azsphere device enable-development 命令（在以前预览版 SDK 中称为 azsphere device prep-debug）添加了此功能。

若要删除该功能，请使用 azsphere device enable-cloud-test：

azsphere device enable-cloud-test --device-group <device-group-ID> or '<product-name>/<device-group-name>'

参数 --device-group 标识设备组。 设备组 ID 提供 GUID，用于在所有产品中唯一标识设备组。 或者，可以使用产品名称>/<device-group-name 格式的产品名称和设备组名称>对<。 这对名称唯一地标识了特定产品的设备组。 有关详细信息，请参阅 部署创建。

创建设备组的部署

部署可以同时包含应用程序和板配置，并且在创建部署时以相同的方式处理它们。 部署是要分发给设备组中所有设备的映像集。 每个部署都链接到特定产品中的特定设备组。 创建部署时，必须包含产品名称和设备组名称（如下例所示）或设备组 ID。

若要创建部署：

  1. 上传映像包：

    azsphere image add --image <path-to-image>  --regional-data-boundary <value>

  2. 为设备组创建新部署：

    azsphere device-group deployment create --device-group <device-group-ID> --images <image-ID>

    或

    azsphere device-group deployment create '<product-name>/<device-group-name>' --images <image-ID>

为输入用空格分隔的值列表提供多个值 --images 。

参数 --device-group 标识设备组。 设备组 ID 提供 GUID，用于在所有产品中唯一标识设备组。 或者，可以使用产品名称>/<device-group-name 格式的产品名称和设备组名称>对<。 这对名称唯一地标识了特定产品的设备组。

该 --images 参数为应用程序提供映像包文件的图像 ID。 将映像上载到当前租户。

该 --regional-data-boundary 参数指定此图像的区域数据边界。 允许的值为 EU 和 None。 默认值为 None。 如果未指定任何值，将使用默认值。

例如：

azsphere image add --image my-app.imagepackage --regional-data-boundary "None"

azsphere device-group deployment create --device-group "DW100/Field Test" --images e3769536-dc4b-48d9-afd4-22ed321ba4bc

有效部署的规则

若要有效，部署必须遵循以下规则：

  • 部署的总大小必须小于 1 MiB。
  • 部署不能包含多个板配置文件。

更新部署

若要更新部署，请使用 azsphere image add 和 azsphere device-group deployment create commands，如上一部分所述，并指定更新的应用程序文件的路径。