教程：创建云部署

  • 项目

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

本教程介绍如何：

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

先决条件

创建产品

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

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

az sphere product create --resource-group MyResourceGroup --catalog MyCatalog --name MyProduct --description "My First Product"

产品名称在 Azure Sphere 目录中必须唯一且不区分大小写。 如果名称包含空格，请在命令中用双引号将其引起来。

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

为设备启用基于云的部署

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

az sphere device enable-cloud-test --catalog MyCatalog --resource-group MyResourceGroup --product MyProduct

此命令：

  • 将设备标识为在上一步中创建的 MyProduct 模型。
  • 默认情况下，将设备分配给现场测试设备组，这将启用基于云的应用程序更新。
  • 禁用 SDK 将应用程序加载到设备的功能，以便只能加载基于云的应用程序。

创建部署

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

若要创建部署，请执行以下操作：

  1. 使用 az sphere image add 将映像包上传到 Azure Sphere 目录。

  2. 使用 az sphere deployment create 为上传的图像的设备组创建新部署。

  3. 上传映像包：

     az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path <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. 为设备组创建新部署：

    az sphere deployment create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group <device-group-ID> --images <image-ID>

  2. 若要提供多个值，请输入 --images 用空格分隔的值列表。

  3. 指定“现场测试”设备组和在 “创建产品”中创建的产品的名称。

  4. 将 替换为<image-ID>在教程：生成高级应用程序中创建的映像包的映像 ID。

  5. 若要验证部署是否已设置，请使用 az sphere image list-targeted 命令。

触发部署

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

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

后续步骤

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

继续学习下一篇文章，了解如何：

生成支持实时的应用程序

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

解决

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

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