Azure portal から Azure IoT Edge モジュールをデプロイする

適用対象: IoT Edge 1.5

ビジネス ロジックで IoT Edge モジュールを作成したら、それらをデバイスにデプロイしてエッジで動作させます。 連携してデータを収集および処理する複数のモジュールがある場合は、一度にそのすべてをデプロイし、それらを接続するルーティング規則を宣言できます。

この記事では、Azure Portal を使用して配置マニフェストを作成し、IoT Edge デバイスにデプロイをプッシュする方法を紹介します。 共有タグに基づいて複数のデバイスを対象とするデプロイを作成する方法については、 Azure portal を使用した大規模な IoT Edge モジュールのデプロイに関するページを参照してください。

前提条件

• Azure サブスクリプション内の IoT ハブ。

• IoT Edge デバイス。

  IoT Edge デバイスがセットアップされていない場合は、Azure 仮想マシンで作成できます。 クイックスタート記事のいずれかの手順に従って、 仮想 Linux デバイスを作成 するか、 仮想 Windows デバイスを作成します。

配置マニフェストを構成する

配置マニフェストは、デプロイするモジュール、モジュール間でのデータ フロー、およびモジュール ツインの目的のプロパティを記述した JSON ドキュメントです。 配置マニフェストの動作と作成方法の詳細については、「 IoT Edge でモジュールをデプロイしてルートを確立する方法」を参照してください。

Azure Portal には、JSON ドキュメントを手動で作成する代わりに配置マニフェストを作成する手順を示すウィザードがあります。 3 つのステップがあります。モジュールの追加、ルートの指定、およびデプロイの確認。

デバイスを選択してモジュールを追加する

1. Azure Portal にサインインし、IoT Hub に移動します。

2. 左側のウィンドウで、[デバイス管理] メニューの[デバイス] を選択します。

3. 一覧からターゲット IoT Edge デバイスを選択します。

4. 上部のバーで [モジュールの設定] を選択します。

5. ページの [Container Registry の資格情報] セクションで、モジュール イメージを格納するコンテナー レジストリにアクセスするための資格情報を指定します。 たとえば、モジュールがプライベート コンテナー レジストリにある場合や、認証が必要なパートナー コンテナー レジストリを使用している場合などです。

6. ページの [IoT Edge モジュール] セクションで、[追加] を選択します。

   

7. ドロップダウン メニューから追加するモジュールの種類を選びます。 IoT Edge モジュールまたは Azure Stream Analytics モジュールを追加できます。

IoT Edge モジュール

このオプションを使用して、Microsoft モジュール、パートナー モジュール、またはカスタム モジュールを追加します。 モジュール名とコンテナー イメージ URI を指定します。 コンテナー イメージ URI は、コンテナー レジストリ内のモジュール イメージの場所です。 Microsoft IoT Edge モジュール イメージの一覧については、「Microsoft アーティファクト レジストリ」を参照してください。 パートナー モジュールの場合、コンテナー イメージ URI を取得するには、IoT Edge モジュールの発行元に問い合わせてください。

たとえば、Microsoft の Simulated Temperature Sensor モジュールを追加するには、次のようにします。

1. 次の情報を入力します :

   設定	価値
   画像の URL	mcr.microsoft.com/azureiotedge-simulated-temperature-sensor
   再起動ポリシー	常時
   必要な状態	実行中

   

2. [追加] を選択します。

3. モジュールを追加したら、一覧からモジュール名を選択してモジュールの設定を開きます。 必要な場合は、省略可能なフィールドに入力します。

   

指定可能なモジュール設定の詳細については、モジュールの構成と管理に関するページを参照してください。

モジュール ツインの詳細については、「必要なプロパティの定義または更新」を参照してください。

Azure Stream Analytics モジュール

このオプションは、Azure Stream Analytics ワークロードから生成されたモジュールに使用します。

1. 自分のサブスクリプションと、作成した Azure Stream Analytics Edge ジョブを選びます。
2. [保存] を選択します。

IoT Edge モジュールで Azure Stream Analytics をデプロイする方法の詳細については、「チュートリアル: Azure Stream Analytics を IoT Edge モジュールとしてデプロイする」を参照してください。

ルートを指定する

[ ルート ] タブでは、モジュールと IoT ハブの間でメッセージを渡す方法を定義します。 メッセージは、名前と値のペアを使用して作成されます。 既定では、新しいデバイスの最初のデプロイにはルートと呼ばれる ルート が含まれ、 FROM /messages/* INTO $upstreamとして定義されます。これは、モジュールによって出力されたすべてのメッセージが IoT ハブに送信されることを意味します。

priority パラメーターと time to live パラメーターは、ルート定義に含めることができる省略可能なパラメーターです。 priority パラメーターでは、メッセージが最初に処理されるルート、または最後に処理されるルートを選択できます。 優先度は 0 から 9 の数値で設定されます (最高優先度は 0)。 time to live パラメーターでは、メッセージが処理されるかキューから削除されるまで当該ルートに保持しておく期間を宣言できます。

ルートの作成方法の詳細については、「ルートの宣言」をご覧ください。

ルートが設定されたら、 [次へ: 確認と作成] を選択し、ウィザードの次の手順に進みます。

デプロイを確認する

確認のセクションには、前述の 2 つのセクションの選択項目に基づいて作成された JSON 配置マニフェストが表示されます。 追加しなかった宣言済みのモジュールには、 $edgeAgent と $edgeHubの 2 つがあります。 これらの 2 つのモジュールは、IoT Edge ランタイムを構成し、すべてのデプロイの既定値として使用されます。

デプロイ情報を確認し、[作成] を選択します。

デバイス上のモジュールを表示する

モジュールをデバイスにデプロイすると、IoT ハブのデバイスの詳細ページですべてのモジュールを表示できます。 このページには、デプロイされた各モジュールの名前と、デプロイの状態や終了コードなどの有用な情報が表示されます。

[次へ: ルート] を選択し、この記事の「ルートの指定とデプロイの確認」の説明に従ってデプロイを続行します。

次のステップ

Azure portal を使用して大規模に IoT Edge モジュールをデプロイする方法について説明します。