練習 - 建立 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 權杖,以供稍後在此課程模組中使用。

  1. 在 Azure Cloud Shell 中執行下列命令,為 Azure IoT Central 應用程式產生唯一的名稱,並將它儲存於環境變數,以供稍後使用:

    APP_NAME="store-manager-$RANDOM"
    echo "Your application name is: $APP_NAME"
    

    記下應用程式名稱,以防萬一殼層逾時和遺失環境變數。

  2. 若在沙箱中建立 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"
    
    

    預期此命令需要一或兩分鐘的時間來執行。

  3. 在另一個瀏覽器索引標籤或視窗中,移至前一個命令輸出中所顯示的 URL。 此 Web UI 頁面是上傳 IoT Edge 部署資訊清單的位置:

    螢幕擷取畫面顯示您在 Azure IoT Central 應用程式中管理 IoT Edge 部署資訊清單所在的部署資訊清單頁面。

  4. 選取 [建立邊緣資訊清單]、輸入名稱「環境感應器」、選取 [上傳檔案],然後瀏覽以選取您先前下載的 EnvironmentalSensorManifest-1-4.json 檔案。

  5. 選取 [下一步],然後選取 [建立] 以上傳資訊清單。 資訊清單會設定三個 IoT Edge 模組:edgeAgentedgeHubSimulatedTemperatureSensor

  6. 接下來,選取 [裝置範本]。 此 Web UI 頁面是建立裝置範本的位置:

    此螢幕擷取畫面顯示在 Azure IoT Central 應用程式中管理範本的裝置範本頁面。

  7. 選取 [建立裝置範本],選擇 [Azure IoT Edge] 磚,然後選取 [下一步:自訂]

  8. 輸入環境感應器邊緣裝置作為裝置範本名稱。 然後,選取 [下一步: 檢閱]

  9. 選取 [建立] 以建立裝置範本。 然後,選取 [自訂模型] 以從空白模型開始。

您上傳的部署資訊清單有一個稱為 SimulatedTemperatureSensor 的模組,其介面稱為 [管理]。 [管理] 介面包含可寫入的屬性 SendDataSendInterval。 若要將此資訊新增至新的裝置範本,請遵循下列步驟:

  1. 在裝置範本頁面上,選取 [模型] 區段中的 [模組]。

  2. 選取 [從資訊清單匯入模組]:

    螢幕擷取畫面顯示從部署資訊清單匯入模組定義所在的裝置範本頁面。

  3. 選取 [環境感應器] 部署資訊清單以匯入模組。

您的裝置範本現在包含 SimulatedTemperatureSensor 模組與 [管理] 介面。 介面會定義 SendDataSendInterval 可寫入的屬性。

部署資訊清單不包含裝置模組所傳送遙測的相關資訊。 若要啟用 Azure IoT Central 來建立遙測的視覺效果,請新增具有必要定義的介面:

  1. 選取 [SimulatedTemperatureSensor] 模組,然後選取 [+ 新增繼承介面]。 您可能必須選取省略符號按鈕 (...) 才能看到此選項。

  2. 選擇 [匯入介面] 圖格,然後選取先前下載的 TelemetryInterface.json 檔案。

    [遙測] 介面會將機器環境遙測類型定義為物件。 機器物件包括溫度和壓力遙測。 環境物件包括溫度和濕度遙測。 介面也會將 timeCreated 包含為 DateTime 遙測類型。

    顯示裝置範本中遙測介面的螢幕擷取畫面。

若要啟用操作員來記錄每個 IoT Edge 裝置的相關資訊,請將下列雲端屬性新增至環境感應器邊緣裝置模型:

Display name 名稱 功能類型 結構描述
商店名稱 StoreName 屬性 String
服務日期 ServiceDate 屬性 Date

顯示裝置範本中雲端屬性的螢幕擷取畫面。

提示

您必須展開雲端屬性,才能看到結構描述設定。

選取儲存以儲存變更。

若要讓操作員能夠從您的商店中查看環境資料,請將下列檢視新增至裝置範本:

  1. 若要加入新的檢視,請選取裝置範本中的 [檢視]。 然後選擇 [將裝置視覺化] 磚。

    顯示裝置範本中 [將裝置圖格視覺化] 的螢幕擷取畫面。

  2. 將檢視的名稱變更為檢視 IoT Edge 裝置遙測

  3. 選取 [使用裝置啟動]

  4. 新增環境/溫度濕度電腦/溫度壓力遙測類型,然後選取 [新增磚]

  5. 選取 [儲存]。

    顯示遙測資料檢視定義的螢幕擷取畫面。

若要讓操作員能記錄每個商店的相關資訊並管理裝置,請將下列檢視新增至裝置範本:

  1. 若要加入新的檢視,請選取裝置範本中的 [檢視]。 然後選擇 [編輯裝置和雲端資料] 磚。

  2. 將表單名稱變更為商店資訊

  3. 選取 [商店名稱] 和 [服務日期] 雲端屬性。 然後選取 [新增區段]

  4. 選取 [儲存]。

    顯示雲端屬性表單定義的螢幕擷取畫面。

您現在已準備好發佈範本和新增裝置:

  1. 在頁面頂端附近,選取 [發佈],然後在 [將此裝置範本發佈到應用程式] 對話方塊中,選取 [發佈]

  2. 移至 Azure IoT Central 應用程式中的 [裝置] 頁面。

  3. 選取 [環境感應器邊緣裝置] 裝置範本,然後選取 [+ 新增]。

  4. 在 [建立新的裝置] 對話方塊中,輸入 store-001 作為裝置識別碼。 確定裝置範本為 [環境感應器 Edge 裝置],且 [Azure IoT Edge 裝置?] 已設定為 [是]。 然後,選取 [環境感應器] 作為邊緣資訊清單。 選取建立

Store-001 裝置會出現在裝置清單中,狀態為已註冊

顯示裝置清單中已註冊裝置的螢幕擷取畫面。

檢查您的工作

  1. 在裝置清單中,選取裝置名稱 [Environmental Sensor Edge Device - store-001]。 您可以看到裝置的可用檢視,包括 [商店資訊] 和 [檢視 IoT Edge 裝置遙測]

  2. 在頁面頂端附近,選取 [連線]。 記下識別碼範圍主要金鑰。 您稍後會使用這些值來設定 IoT Edge 裝置,以連接到您的應用程式。

    在網頁瀏覽器中保持此頁面開啟。 您稍後會返回此 Azure IoT Central 應用程式。

您已建立應用程式來管理您的商店。 建立一個裝置範本,並在其中包含您計畫於商店安裝的裝置 IoT Edge 部署資訊清單。 此範本包含的檢視可讓操作員監視商店中的環境狀況,並從遠端系統管理裝置。