演習 - Azure IoT Central アプリケーションを作成する

完了

IoT Edge デバイスを接続して管理するための Azure IoT Central アプリケーションを作成します。

あなたは各店舗に IoT Edge デバイスを展開してローカル センサーを管理し、Azure IoT Central に送信されるデータをフィルター処理する予定であるという設定でした。

ここでは、Azure CLI を使用し、カスタム アプリケーション テンプレートから Azure IoT Central アプリケーションを作成します。 Azure サンドボックスで CLI コマンドを実行した後、アプリケーションの Web UI に移動します。 Web UI で、IoT Edge デバイス用のデバイス テンプレートを追加することによって、セットアップを完了します。

Note

この演習は省略してもかまいません。 この演習を実行する場合は、始める前に 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"
    
    

    このコマンドの実行には 1、2 分かかる場合があります。

  3. ブラウザーの別のタブまたはウィンドウで、前のコマンドの出力に表示されている URL に移動します。 この Web UI ページでは、IoT Edge の配置マニフェストをアップロードします。

    Azure IoT Central アプリケーションで IoT Edge の配置マニフェストを管理する配置マニフェスト ページを示すスクリーンショット。

  4. [エッジ マニフェストを作成] を選び、「Environmental Sensor」という名前を入力し、[ファイルのアップロード] を選んでから、先にダウンロードした EnvironmentalSensorManifest-1-4.json ファイルを見つけて選びます。

  5. [次へ] を選んでから、[作成] を選んでマニフェストをアップロードします。 マニフェストにより、edgeAgentedgeHubSimulatedTemperatureSensor という 3 つの IoT Edge モジュールが構成されます。

  6. 次に、[デバイス テンプレート] を選択します。 この Web UI ページでは、デバイス テンプレートを作成します。

    Azure IoT Central アプリケーションでテンプレートを管理するデバイス テンプレート ページのスクリーンショット。

  7. [デバイス テンプレートの作成] を選択し、[Azure IoT Edge] タイルを選択して、[次へ: カスタマイズ] を選択します。

  8. デバイス テンプレート名として「Environmental Sensor Edge Device」 と入力します。 次に、次のステップ: 確認\) をクリックします。

  9. [作成] を選択してデバイス テンプレートを作成します。 次に、[カスタム モデル] を選んで、空のモデルから始めます。

アップロードした配置マニフェストには、SimulatedTemperatureSensor という名前のモジュールと、management という名前のインターフェイスがあります。 management インターフェイスには、書き込み可能なプロパティ SendDataSendInterval が含まれています。 この情報を新しいデバイス テンプレートに追加するには、次の手順を実行します。

  1. デバイス テンプレートのページで、[モデル] セクションの [モジュール] を選びます。

  2. [マニフェストからモジュールをインポートする] を選びます。

    配置マニフェストからモジュール定義をインポートするデバイス テンプレート ページを示すスクリーンショット。

  3. Environmental Sensor 配置マニフェストを選んで、モジュールをインポートします。

デバイス テンプレートに、SimulatedTemperatureSensor モジュールと management インターフェイスが含まれるようになります。 インターフェイスでは、書き込み可能なプロパティ SendDataSendInterval が定義されています。

配置マニフェストには、デバイス モジュールによって送信されるテレメトリに関する情報は含まれません。 Azure IoT Central でテレメトリ用の視覚エフェクトを作成できるようにするには、必要な定義を含むインターフェイスを追加します。

  1. SimulatedTemperatureSensor モジュールを選択し、[+ 継承されたインターフェイスの追加] を選択します。 このオプションを表示するには、必要に応じて省略記号ボタン ([...]) を選択します。

  2. [インターフェイスのインポート] タイルを選択し、先ほどダウンロードした TelemetryInterface.json ファイルを選択します。

    Telemetry インターフェイスでは、machineambient というテレメトリ型がオブジェクトとして定義されています。 machine オブジェクトには、temperature と pressure というテレメトリが含まれています。 ambient オブジェクトには、temperature と humidity というテレメトリが含まれています。 インターフェイスには、DateTime テレメトリ型として timeCreated も含まれています。

    デバイス テンプレートの Telemetry インターフェイスを示すスクリーンショット。

オペレーターが各 IoT Edge デバイスに関する情報を記録できるようにするには、次のクラウド プロパティEnvironmental Sensor Edge Device モデルに追加します。

表示名 名前 機能の種類 スキーマ
店舗名 StoreName プロパティ String
Service Date ServiceDate プロパティ

デバイス テンプレートのクラウドのプロパティを示すスクリーンショット。

ヒント

スキーマの設定を表示するには、クラウドのプロパティを展開する必要があります。

[保存] を選択して変更を保存します。

オペレーターが店舗からの環境データを表示できるようにするには、次のビューをデバイス テンプレートに追加します。

  1. 新しいビューを追加するには、デバイス テンプレートで [ビュー] を選択します。 次に、[デバイスの視覚化] タイルを選択します。

    デバイス テンプレートの [デバイスの視覚化] タイルを示すスクリーンショット。

  2. ビューの名前を "View IoT Edge device telemetry" に変更します。

  3. [Start with devices](デバイスを使用して開始) を選択します。

  4. ambient/temperaturehumiditymachine/temperaturepressure の各テレメトリ型を追加し、[タイルの追加] を選択します。

  5. [保存] を選択します。

    テレメトリ ビューの定義を示すスクリーンショット。

オペレーターが各店舗に関する情報を記録し、デバイスを管理できるようにするには、次のビューをデバイス テンプレートに追加します。

  1. 新しいビューを追加するには、デバイス テンプレートで [ビュー] を選択します。 次に、[デバイスとクラウドのデータの編集] タイルを選択します。

  2. フォーム名を "Store information" に変更します。

  3. クラウド プロパティ Store NameService Date を選択します。 次に、 [セクションの追加] を選択します。

  4. [保存] を選択します。

    クラウド プロパティ フォームの定義を示すスクリーンショット。

これで、テンプレートを発行してデバイスを追加する準備ができました。

  1. ページの上部近くにある [発行] を選択し、[このデバイス テンプレートのアプリケーションへの発行] ダイアログで [発行] を選択します。

  2. Azure IoT Central アプリケーションの [デバイス] ページに移動します。

  3. Environmental Sensor Edge デバイス テンプレートを選んでから、[+ 新規] を選びます。

  4. [新しいデバイスを作成します] ダイアログで、デバイス ID として「store-001」と入力します。 デバイス テンプレートが Environmental Sensor Edge Device であり、[Azure IoT Edge デバイスですか?] が既に [はい] に設定されていることを確認します。 次に、エッジ マニフェストとして [環境センサー] を選択します。 [作成] を選択します。

store-001 デバイスが、[登録済み] 状態でデバイスの一覧に表示されます。

デバイス一覧に登録済みデバイスを示すスクリーンショット。

作業を確認

  1. デバイスの一覧で、デバイス名 Environmental Sensor Edge Device - store-001 を選択します。 Store informationView IoT Edge device telemetry など、デバイスで使用できるビューが表示されます。

  2. ページの上部近くにある [接続] を選択します。 [ID スコープ][主キー] を記録しておきます。 これらの値は、後でアプリケーションに接続するように IoT Edge デバイスを構成するために使用します。

    このページを Web ブラウザーで開いたままにします。 後でこの Azure IoT Central アプリケーションに戻ります。

ストアを管理するアプリケーションを作成しました。 ストアにインストールする予定のデバイス用 IoT Edge 配置マニフェストを含むデバイス テンプレートを作成しました。 このテンプレートには、オペレーターが店舗内の環境条件を監視し、デバイスをリモートで管理できるビューが含まれています。