创建云部署

  • 项目

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

部署必须遵循以下规则才能有效：

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

准备设备

设备必须具有产品并属于设备组，并且不能安装 AppDevelopment 功能 ，然后设备才能从云接收应用程序。

如果尚未为设备创建产品，则需要先创建产品，然后才能创建部署。 若要创建产品，请：

使用门户

    • 登录到 Azure 门户。
    • 若要查找 Azure Sphere 服务，请在顶部搜索栏中输入并选择“ Azure Sphere”。 显示“Azure Sphere”页。
  2. 选择要在其中创建部署的目录。 确保已正确设置订阅筛选器，以查看所有目录和资源组。
  3. 从目录页左侧选择“ 管理>产品 ”。
  4. 单击目录页顶部的“ + 创建 ”。
  5. 输入产品的名称和说明。 标记复选框以指示是否应创建默认设备组。 如果已标记，将创建以下默认设备组：开发、现场测试、现场测试 OS 评估、生产、生产 OS 评估。
  6. 最后，单击页面底部的“ 创建 ”。

如果选择不创建默认设备组，则必须手动创建设备组并将其关联到产品：

  1. 从页面左侧选择“ 管理>设备组 ”。
  2. 单击页面顶部的“ + 创建 ”。
  3. 选择从上述步骤中创建的产品。
  4. 输入设备组的名称和简短说明。
  5. 选择设备组的操作系统 (操作系统) 源。 RetailEval 源在零售源之前接收预发行的 OS 版本。 因此，不建议将 RetailEval 用于生产设备。 为生产设备选择 零售 源。
  6. 选择设备组的更新策略。 UpdateAll 表示组中的设备将在可用时进行 OS 和应用程序更新。 No3rdPartyAppUpdates 意味着组中的设备将仅接受 OS 更新。

使用 CLI

提示

建议为订阅、资源组和目录参数 配置默认值 。 这有助于减少冗余，并可以显著缩短 CLI 命令语法。

除非已设置活动订阅， --subscription 否则所有命令都需要 参数。 可以使用命令 az account set --subscription <subscription-name>设置活动订阅。

az sphere product create使用 命令。

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

az sphere device-group create使用 命令创建设备组并将其与产品关联。

az sphere device-group create --resource-group MyResourceGroup --catalog MyCatalog   --name "My Development Device Group" --product MyProduct -d "development device group for MyProduct"

部署目标 设备组。 设备需要分配到启用了云更新 的设备组 ，然后设备才能接收已部署的应用程序。 默认情况下，每个产品都有五个设备组：生产、现场测试、开发、现场测试 OS 评估和生产 OS 评估。 可以使用其中一个设备组或 创建自己的设备组。 若要了解设备组是否接受云更新，请使用 az sphere device-group show。

设备组中的设备必须准备好进行云加载。 这意味着它们不得具有 appDevelopment 功能。 直接从工厂发货的设备通常没有 appDevelopment 功能。 使用 az sphere device enable-development 命令时，将添加此功能。

若要删除 appDevelopment 功能，请使用 az sphere device enable-cloud-test：

使用 CLI

az sphere device enable-cloud-test使用 命令。

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

为设备组创建部署

部署是要分发到设备组内所有设备的映像集。 部署可以包含应用程序和板配置。 每个部署都链接到特定产品中的特定设备组。 必须包括产品名称和设备组名称 (如以下示例所示，在创建部署时) 或设备组 ID。

使用门户

    • 登录到 Azure 门户。
    • 若要查找 Azure Sphere 服务，请在顶部搜索栏中输入并选择“ Azure Sphere”。 显示“Azure Sphere”页。
  2. 选择要在其中创建部署的目录。 确保已正确设置订阅筛选器，以查看所有目录和资源组。
  3. 选择页面左侧的“ 管理>产品 ”。
  4. 下一页显示一个表，其中列出了所有已创建的产品。 选择要为其创建部署的产品。
  5. 表显示与所选产品关联的所有设备组。 选择要为其创建部署的设备组。
  6. 选择“ 部署 ”选项卡。
  7. 单击“部署”选项卡下的“ +创建 ”。
  8. 在显示的视图中，选择和现有图像，或单击“ +添加” 上传新图像。
  9. 在视图底部，单击“ +创建”。

使用 CLI

在继续操作之前完成 准备设备 中的步骤，然后：

  1. 上传映像包，记下 命令返回的 imageId：

    az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path myImage.imagepackage

  2. azsphere image-package show使用 命令获取映像包的 imageId：

    azsphere image-package show --image-package myImage.imagepackage

    注意

    image-package show 目前在 Azure CLI 扩展中不受支持。

    命令返回有关映像包的信息，包括 imageId：

    Image package metadata:
  Section: Identity
   Image Type: Application
   Component ID: 1689d8b2-c835-2e27-27ad-e894d6d15fa9
   Image ID: be3f90bd-849f-487e-a170-7fe1ff03fe2d
  Section: Signature
   Signing Type: ECDsa256
   Cert: a8d5cc6958f48710140d7a26160fc1cfc31f5dfO
  Section: Debug 
   Image Name:       myImage
   Built On (UTC):   02/21/22 16:21:58
   Built On (Local): 02/21/22 16:21:58
  Section: Temporary Image

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

    az sphere deployment create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --images <imageId returned from previous step>

可以使用以空格分隔的图像 ID 列表向 --images 参数提供多个图像。

若要列出目录中的设备组，请使用 az sphere device-group list。

若要列出目录中的所有图像，请使用 az sphere image list。

更新部署

无法更新部署。 相反，必须创建新的部署。 重复上一部分中的步骤，根据需要更新参数。