共用方式為

建立部署

  • 發行項

重要

這是 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 product。

部署目標裝置群組，因此您也必須將裝置指派給裝置群組，以啟用雲端更新，才能接收已部署的應用程式。 根據預設，每個產品都有五個裝置群組：生產、現場測試、開發、現場測試 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 會識別裝置群組。 裝置群組標識碼提供 GUID，可唯一識別所有產品的裝置群組。 或者，您可以使用 product-name</device-group-name 格式的>產品名稱和裝置組名組名<>組。 這組名稱可唯一識別特定產品的裝置群組。 如需詳細資訊，請參閱 部署建立。

建立裝置群組的部署

部署可以同時包含應用程式和面板組態，當您建立部署時，兩者都會以相同的方式處理。 部署是一組要散發至裝置群組內所有裝置的映像。 每個部署都會連結到特定產品內的特定裝置群組。 建立部署時，您必須包含產品名稱和裝置組名（如下列範例所示）或裝置群組標識符。

若要建立部署：

  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 會識別裝置群組。 裝置群組標識碼提供 GUID，可唯一識別所有產品的裝置群組。 或者，您可以使用 product-name</device-group-name 格式的>產品名稱和裝置組名組名<>組。 這組名稱可唯一識別特定產品的裝置群組。

參數 --images 會為應用程式提供映像套件檔案的映像標識碼。 映射會上傳至您目前的租使用者。

參數 --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 命令，如上一節所述，並指定更新應用程式檔案的路徑。