共用方式為

教學課程：建立雲端部署

  • 發行項

重要

這是 Azure Sphere （舊版） 檔。 Azure Sphere（舊版）將於 2027 年 9 月 27 日淘汰，且使用者此時必須移轉至 Azure Sphere（整合式）。 使用位於 TOC 上方的版本選取器來檢視 Azure Sphere （整合式） 檔。

本快速入門說明如何建立您的第一個雲端式應用程式部署。 雲端式部署會透過指派給目標產品內裝置群組的部署來傳遞應用程式。

在本教學課程中，您會了解如何：

  • 建立產品
  • 為您的裝置啟用雲端式部署
  • 建立部署
  • 觸發程式部署
  • 重新啟用開發和偵錯

必要條件

  • 您的 Azure Sphere 裝置會連線到您的電腦和因特網。
  • 您已完成教學 課程：建置高階應用程式 ，並具有應用程式的映像套件檔案。

建立產品

產品會識別執行特定函式並執行特定應用程式的 Azure Sphere 裝置模型。

如果您還沒有產品，請使用 azsphere product create 命令建立 一個產品。

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

產品名稱在您的 Azure Sphere 租用戶中必須是唯一的，而且不區分大小寫。 如果名稱包含空格，請在命令中以雙引弧括住它，如範例所示。

azsphere product create 命令會自動為新產品建立五個預設裝置群組：開發、現場測試、生產、現場測試 OS 評估，以及生產操作系統評估。 裝置群組可讓您根據裝置使用方式來組織裝置。

為您的裝置啟用雲端式部署

在測試雲端式部署程式之前，您的 Azure Sphere 裝置必須準備好接受雲端式應用程式更新。 使用 azsphere device enable-cloud-test 命令來準備您的裝置：

azsphere device enable-cloud-test --product MyProduct

此命令：

  • 將裝置識別為在上一個步驟中建立的 MyProduct 模型。
  • 將裝置指派給現場測試裝置群組，以啟用雲端式應用程式更新。
  • 停用 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>'.

在下一個步驟中，您將使用映像標識符。

  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 和裝置群組 Field Test，您可以使用第二個窗體輕鬆地建立部署：

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

若要提供多個值，以 --images 輸入以空格分隔的值清單。

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

指定 [現場測試] 裝置群組，以及您在 [建立產品] 中建立的產品名稱。

將 image-ID> 取代<為您在教學課程：建置高階應用程式中所建立映像套件的映射標識符。 針對 Azure Sphere CLI，請參閱 azsphere device-group deployment create 以取得映像標識符的相關信息。

若要確認部署已設定，請使用 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。

請前往下一篇文章以了解如何：

建置即時可用的應用程式

如果您尚未準備好建置即時應用程式，您可能也想要：

疑難排解

如果您遇到上述作業的問題，請參閱 疑難解答指引。