練習 - 建立 Azure IoT Central 應用程式
建立 Azure IoT Central 應用程式,讓您的 IoT Edge 裝置可以連線並從中進行管理。
請回想一下,您計畫在每個商店中部署 IoT Edge 裝置來管理本機感應器,並篩選傳送至 Azure IoT Central 的資料。
在這裡,您將使用 Azure CLI 從 [自訂應用程式] 範本中建立 Azure IoT Central 應用程式。 您會在 Azure 沙箱中執行 CLI 命令,然後移至應用程式的 Web UI。 在 Web UI 中,您可以新增 IoT Edge 裝置的裝置範本來完成設定。
注意
此練習為選擇性項目。 如果想要完成此練習,您必須先建立 Azure 訂用帳戶,再開始進行。 如果您沒有 Azure 帳戶,或者目前不想建立帳戶,您可以閱讀相關指示,以了解所呈現的資訊。
下載部署資訊清單
當您為 IoT Edge 裝置建立裝置範本時,需要部署資訊清單和本機電腦上的介面定義。 若要下載這些檔案,請以滑鼠右鍵按一下這些連結,然後選擇 [另存新檔]:
記住檔案的儲存位置,稍後您會需要這些檔案。
建立並設定 Azure IoT Central 應用程式
下列步驟會建立 Azure IoT Central 應用程式並產生 API 權杖,以供稍後在此課程模組中使用。
在 Azure Cloud Shell 中執行下列命令,為 Azure IoT Central 應用程式產生唯一的名稱,並將它儲存於環境變數,以供稍後使用:
APP_NAME="store-manager-$RANDOM" echo "Your application name is: $APP_NAME"
記下應用程式名稱,以防萬一殼層逾時和遺失環境變數。
若在沙箱中建立 Azure IoT Central 應用程式,在 Cloud Shell 中執行下列命令:
az iot central app create \ --resource-group <rgn>[sandbox resource group name]</rgn> \ --name $APP_NAME --sku ST2 --location centralus \ --subdomain $APP_NAME --template iotc-pnp-preview \ --display-name 'Store Management' echo "You can now navigate to: https://$APP_NAME.azureiotcentral.com/edge-manifests"
預期此命令需要一或兩分鐘的時間來執行。
在另一個瀏覽器索引標籤或視窗中,移至前一個命令輸出中所顯示的 URL。 此 Web UI 頁面是上傳 IoT Edge 部署資訊清單的位置:
選取 [建立邊緣資訊清單]、輸入名稱「環境感應器」、選取 [上傳檔案],然後瀏覽以選取您先前下載的 EnvironmentalSensorManifest-1-4.json 檔案。
選取 [下一步],然後選取 [建立] 以上傳資訊清單。 資訊清單會設定三個 IoT Edge 模組:edgeAgent、edgeHub 和 SimulatedTemperatureSensor。
接下來,選取 [裝置範本]。 此 Web UI 頁面是建立裝置範本的位置:
選取 [建立裝置範本],選擇 [Azure IoT Edge] 磚,然後選取 [下一步:自訂]。
輸入環境感應器邊緣裝置作為裝置範本名稱。 然後,選取 [下一步: 檢閱]。
選取 [建立] 以建立裝置範本。 然後,選取 [自訂模型] 以從空白模型開始。
您上傳的部署資訊清單有一個稱為 SimulatedTemperatureSensor 的模組,其介面稱為 [管理]。 [管理] 介面包含可寫入的屬性 SendData 和 SendInterval。 若要將此資訊新增至新的裝置範本,請遵循下列步驟:
在裝置範本頁面上,選取 [模型] 區段中的 [模組]。
選取 [從資訊清單匯入模組]:
選取 [環境感應器] 部署資訊清單以匯入模組。
您的裝置範本現在包含 SimulatedTemperatureSensor 模組與 [管理] 介面。 介面會定義 SendData 和 SendInterval 可寫入的屬性。
部署資訊清單不包含裝置模組所傳送遙測的相關資訊。 若要啟用 Azure IoT Central 來建立遙測的視覺效果,請新增具有必要定義的介面:
選取 [SimulatedTemperatureSensor] 模組,然後選取 [+ 新增繼承介面]。 您可能必須選取省略符號按鈕 (...) 才能看到此選項。
選擇 [匯入介面] 圖格,然後選取先前下載的 TelemetryInterface.json 檔案。
[遙測] 介面會將機器和環境遙測類型定義為物件。 機器物件包括溫度和壓力遙測。 環境物件包括溫度和濕度遙測。 介面也會將 timeCreated 包含為 DateTime 遙測類型。
若要啟用操作員來記錄每個 IoT Edge 裝置的相關資訊,請將下列雲端屬性新增至環境感應器邊緣裝置模型:
Display name | 名稱 | 功能類型 | 結構描述 |
---|---|---|---|
商店名稱 | StoreName | 屬性 | String |
服務日期 | ServiceDate | 屬性 | Date |
提示
您必須展開雲端屬性,才能看到結構描述設定。
選取儲存以儲存變更。
若要讓操作員能夠從您的商店中查看環境資料,請將下列檢視新增至裝置範本:
若要加入新的檢視,請選取裝置範本中的 [檢視]。 然後選擇 [將裝置視覺化] 磚。
將檢視的名稱變更為檢視 IoT Edge 裝置遙測。
選取 [使用裝置啟動]。
新增環境/溫度、濕度、電腦/溫度和壓力遙測類型,然後選取 [新增磚]。
選取 [儲存]。
若要讓操作員能記錄每個商店的相關資訊並管理裝置,請將下列檢視新增至裝置範本:
若要加入新的檢視,請選取裝置範本中的 [檢視]。 然後選擇 [編輯裝置和雲端資料] 磚。
將表單名稱變更為商店資訊。
選取 [商店名稱] 和 [服務日期] 雲端屬性。 然後選取 [新增區段]。
選取 [儲存]。
您現在已準備好發佈範本和新增裝置:
在頁面頂端附近,選取 [發佈],然後在 [將此裝置範本發佈到應用程式] 對話方塊中,選取 [發佈]。
移至 Azure IoT Central 應用程式中的 [裝置] 頁面。
選取 [環境感應器邊緣裝置] 裝置範本,然後選取 [+ 新增]。
在 [建立新的裝置] 對話方塊中,輸入 store-001 作為裝置識別碼。 確定裝置範本為 [環境感應器 Edge 裝置],且 [Azure IoT Edge 裝置?] 已設定為 [是]。 然後,選取 [環境感應器] 作為邊緣資訊清單。 選取建立。
Store-001 裝置會出現在裝置清單中,狀態為已註冊。
檢查您的工作
在裝置清單中,選取裝置名稱 [Environmental Sensor Edge Device - store-001]。 您可以看到裝置的可用檢視,包括 [商店資訊] 和 [檢視 IoT Edge 裝置遙測]。
在頁面頂端附近,選取 [連線]。 記下識別碼範圍和主要金鑰。 您稍後會使用這些值來設定 IoT Edge 裝置,以連接到您的應用程式。
在網頁瀏覽器中保持此頁面開啟。 您稍後會返回此 Azure IoT Central 應用程式。
您已建立應用程式來管理您的商店。 建立一個裝置範本,並在其中包含您計畫於商店安裝的裝置 IoT Edge 部署資訊清單。 此範本包含的檢視可讓操作員監視商店中的環境狀況,並從遠端系統管理裝置。