通过

教程：创建云部署

  • 项目

重要

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

本快速入门介绍如何创建第一个基于云的应用程序部署。 基于云的部署通过分配给目标产品中的设备组的部署来交付应用程序。

本教程介绍如何执行下列操作：

  • 创建产品
  • 为设备启用基于云的部署
  • 创建部署
  • 触发部署
  • 重新启用开发和调试

先决条件

创建产品

产品标识执行特定功能并运行特定应用程序的 Azure Sphere 设备的模型。

如果还没有产品，请使用 azsphere product create 命令创建一个产品。

azsphere product create --name MyProduct --description "My First Product"

产品名称在 Azure Sphere 租户中必须是唯一的，并且不区分大小写。 如果名称包含空格，请在命令中用双引号将其括起来，如示例中所示。

azsphere product create 命令会自动为新产品创建五个默认设备组：开发、现场测试、生产、现场测试 OS 评估和生产 OS 评估。 设备组提供了一种根据设备使用方式组织设备的方法。

为设备启用基于云的部署

测试基于云的部署过程之前，Azure Sphere 设备必须已准备好接受基于云的应用程序更新。 使用 azsphere device enable-cloud-test 命令准备设备：

azsphere device enable-cloud-test --product MyProduct

此命令：

  • 将设备标识为在上一步中创建的 MyProduct 模型。
  • 将设备分配到 Field Test 设备组，该组可启用基于云的应用程序更新。
  • 禁用 SDK 将应用程序加载到设备的功能，以便只能加载基于云的应用程序。

Azure Sphere 安全服务使用设备组和产品来确定是否在设备上更新应用程序。

创建部署

部署是一组可从 Azure Sphere 云服务部署到特定设备组中的设备的映像。

若要创建部署：

  1. 使用 azsphere image add 将映像包上传到 Azure Sphere 租户。
  2. 使用 azsphere device-group deployment create 为上传的图像创建设备组的新部署。
  1. 上传映像包：
azsphere image add --image <path-to-image>

输出应显示如下所示的内容：

Uploading image from file 'Blink.imagepackage':
 --> Image ID:       <image-ID>
 --> Component ID:   <component-ID>
 --> Component name: 'Blink'
Removing temporary state for uploaded image.
Successfully uploaded image with ID '<image-id>' and name 'Blink' to component with ID '<component-id>'.

下一步将使用映像 ID。

  1. 为设备组创建新部署：
azsphere device-group deployment create --device-group <device-group-ID> --images <image-ID>

或

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

对于产品 MyProduct 和设备组字段测试，可以使用第二个窗体轻松创建部署：

azsphere device-group deployment create --device-group "MyProduct/Field Test" --images <image-ID>

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

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

指定在“创建产品”中创建的产品的字段测试设备组和名称。

将映像 ID 替换为<在教程中创建的映像包的映像 ID：生成高级应用程序。> 有关 Azure Sphere CLI，请参阅 azsphere device-group deployment create ，了解有关获取映像 ID 的信息。

若要验证是否已设置部署，请使用 azsphere device image list-targeted 命令。

触发部署

前面的步骤设置了所有必需的部署元素。 若要立即触发下载，请在 Azure Sphere 设备上按“重置”按钮。 应用程序应在几分钟内下载并启动，然后应看到 LED 开始闪烁。

若要验证应用程序是否已安装在设备上，请使用 azsphere device image list-installed 命令。 可能不会立即看到部署的结果。 如果在运行命令时未列出部署，请在几分钟后重试。 部署完成后，LED 将开始闪烁在 Azure Sphere 设备上。

后续步骤

继续开发和测试应用程序时，在准备好更广泛地部署这些应用程序之前，可能希望旁加载它们。 若要反转 azsphere device enable-cloud-test 命令并启用设备进行开发和调试，请使用 azsphere device enable-development。

转到下一篇文章，了解如何执行以下操作：

生成支持实时的应用程序

如果尚未准备好生成实时应用程序，可能还需要：

疑难解答

如果遇到上述操作的问题，请参阅 故障排除指南。