チュートリアル: 詳細なデプロイフローのために Azure Stack Edge Pro FPGA でデータを変換する

[アーティクル]
02/27/2024

重要

Azure Stack Edge Pro FPGA デバイスは 2024 年 2 月に製造中止となります。新しいデプロイをお考えの場合は、ワークロードに合わせて Azure Stack Edge Pro 2 または Azure Stack Edge Pro GPU デバイスを検討することをお勧めします。

このチュートリアルでは、Azure Stack Edge Pro FPGA デバイス上に詳細なデプロイフロー用のコンピューティングロールを構成する方法について説明します。コンピューティングロールを構成すると、Azure に送信する前に Azure Stack Edge Pro FPGA でデータを変換できるようになります。

コンピューティングは、デバイスでのシンプルまたは詳細なデプロイフロー用に構成できます。

条件	単純なデプロイ	詳細なデプロイ
対象者	IT 管理者	開発者
Type	Azure Stack Edge サービスを使ってモジュールをデプロイする	IoT Hub サービスを使ってモジュールをデプロイする
デプロイされるモジュール	Single	チェーンされたモジュールまたは複数のモジュール

この手順の所要時間は約 20 分から 30 分です。

このチュートリアルでは、以下の内容を学習します。

コンピューティングを構成する
共有を追加する
トリガーの追加
コンピューティングモジュールを追加する
データ変換を検証して転送する

前提条件

Azure Stack Edge Pro FPGA デバイスでコンピューティングロールを設定する前に、次のことを確認してください。

Azure Stack Edge Pro FPGA の接続、設定、アクティブ化に関するページで説明されているとおり、お客様の Azure Stack Edge Pro FPGA デバイスをアクティブ化していること。

コンピューティングを構成する

Azure Stack Edge Pro FPGA でコンピューティングを構成するために、IoT Hub リソースを作成します。

Azure portal で、Azure Stack Edge リソースの [概要] に移動します。右ペインで [IoT Edge] タイルを選択します。
[IoT Edge サービスを有効にする] タイルの [追加] を選択します。この操作によって IoT Edge サービスが有効になり、IoT Edge モジュールをデバイス上にローカルにデプロイできるようになります。

[IoT Edge サービスの作成] で、次の情報を入力します。

フィールド	値
サブスクリプション	IoT Hub リソースのサブスクリプションを選択します。 Azure Stack Edge リソースで使用されているものと同じサブスクリプションを選択できます。
Resource group	IoT Hub リソースのリソースグループの名前を入力します。 Azure Stack Edge リソースで使用されているものと同じリソースグループを選択できます。
IoT Hub	[新規] または [既存] を選択します。既定では、IoT リソースの作成には Standard レベル (S1) が使用されます。 Free レベルの IoT リソースを使用するには、それを作成してから既存のリソースを選択します。
名前	既定値をそのまま使用するか、自分の IoT Hub リソースの名前を入力します。

Get started with compute 3

[確認および作成] を選択します。 IoT Hub リソースの作成には数分かかります。 IoT Hub リソースの作成後、 [概要] が更新されて、IoT Edge サービスが実行中であることが示されます。

Edge デバイスで IoT Edge サービスが構成されると、2 つのデバイスが作成されます (IoT デバイスと IoT Edge デバイス)。 IoT Hub リソースでは、両方のデバイスを表示できます。 IoT Edge ランタイムは、この IoT Edge デバイス上でも動作しています。現時点では、お客様の IoT Edge デバイスに対して使用できるのは Linux プラットフォームのみです。

Edge コンピューティングロールが構成されたことを確認するには、[IoT Edge サービス] > [プロパティ] を選択して、IoT デバイスと IoT Edge デバイスを表示します。

共有を追加する

このチュートリアルの詳細なデプロイでは、2 つの共有が必要になります。1 つは Edge 共有で、もう 1 つは Edge ローカル共有です。

次の手順を実行して、Edge 共有をデバイスに追加します。
1. ご自分の Azure Stack Edge リソースで、[IoT Edge] > [共有] に移動します。
2. [共有] ページで、コマンドバーの [+ 共有の追加] を選択します。
3. [共有の追加] ブレードで、共有名を指定して共有の種類を選択します。
4. Edge 共有をマウントするには、 [Edge コンピューティングで共有を使用する] チェックボックスをオンにします。
5. [ストレージアカウント] 、 [ストレージサービス] 、既存のユーザーを選択して、 [作成] を選択します。
Edge 共有が作成された後、作成成功通知を受け取ります。共有の一覧が更新されて、新しい共有が反映されます。
前の手順の内容をすべて繰り返し、 [Edge ローカル共有として構成] のチェックボックスをオンにして、Edge デバイスに Edge ローカル共有を追加します。ローカル共有内のデータはデバイスに残ります。
[共有] ブレードに、更新された共有の一覧が表示されます。
新しく作成されたローカル共有のプロパティを表示するには、一覧から共有を選択します。 [Edge コンピューティングモジュールのローカルマウントポイント] ボックスで、この共有に対応する値をコピーします。

このローカルマウントポイントはモジュールのデプロイ時に使用します。
作成した Edge 共有のプロパティを表示するには、一覧から共有を選択します。 [Edge コンピューティングモジュールのローカルマウントポイント] ボックスで、この共有に対応する値をコピーします。

このローカルマウントポイントはモジュールのデプロイ時に使用します。

トリガーの追加

Azure Stack Edge リソースに移動し、[IoT Edge] > [トリガー] に移動します。 [+ トリガーの追加] を選択します。

[トリガーの追加] ブレードで、次の値を入力します。

フィールド	値
トリガー名	トリガーの一意の名前。
トリガーの種類	[ファイル] トリガーを選択します。ファイルトリガーは、入力共有へのファイルの書き込みなど、ファイルイベントが発生するたびに起動します。一方、スケジュール済みのトリガーは、お客様によって定義されたスケジュールに基づいて起動します。この例では、ファイルトリガーが必要です。
Input share (入力共有)	入力共有を選択します。この例では、Edge ローカル共有が入力共有です。ここで使用されるモジュールによって、Edge ローカル共有から Edge 共有にファイルが移動され、そこでクラウドにアップロードされます。

Add trigger 2

トリガーが作成された後、通知を受け取ります。トリガーの一覧が更新されて、新しく作成されたトリガーが表示されます。作成したトリガーを選択します。
サンプルのルートをコピーして保存します。このサンプルのルートを変更して後で IoT Hub で使います。

"sampleroute": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/modulename/inputs/input1\")"

モジュールを追加する

この Edge デバイスにはカスタムモジュールがありません。カスタムモジュールまたはあらかじめ構築されたモジュールを追加できます。カスタムモジュールを作成する方法については、Azure Stack Edge Pro FPGA デバイス用の C# モジュールの開発に関するページを参照してください。

このセクションでは、Azure Stack Edge Pro FPGA 用の C# モジュールの開発に関するページでお客様が作成したカスタムモジュールを IoT Edge デバイスに追加します。このカスタムモジュールによって、Edge デバイス上の Edge ローカル共有からファイルが受け取られ、デバイス上の Edge (クラウド) 共有にそれらが移動されます。その後、クラウド共有から、そのクラウド共有に関連付けられた Azure ストレージアカウントにファイルがプッシュされます。

Azure Stack Edge リソースに移動し、[IoT Edge] > [概要] に移動します。 [モジュール] タイルの [Go to Azure IoT Hub](Azure IoT Hub に移動) を選択します。

IoT Hub リソース内で [IoT Edge デバイス] に移動した後、自分の IoT Edge デバイスを選択します。
[デバイスの詳細] で、 [モジュールの設定] を選択します。

[モジュールの追加] で以下を実行します。

カスタムモジュールのコンテナーレジストリの設定で、名前、アドレス、ユーザー名、パスワードを入力します。名前、アドレス、および一覧に示された資格情報は、一致する URL を使用してモジュールを取得するために使用されます。このモジュールをデプロイするには、 [Deployment modules]\(デプロイモジュール) で [IoT Edge module]\(IoT Edge モジュール) を選択します。この IoT Edge モジュールは、お客様の Azure Stack Edge Pro FPGA デバイスに関連付けられている IoT Edge デバイスにデプロイできる Docker コンテナーです。

IoT Edge カスタムモジュールの設定を指定します。次の値を入力します。

フィールド	値
名前	モジュールの一意の名前。このモジュールは、お客様の Azure Stack Edge Pro FPGA に関連付けられている IoT Edge デバイスにデプロイできる Docker コンテナーです。
イメージの URI	モジュールの対応するコンテナーイメージのイメージ URI。
資格情報が必要です	チェックボックスをオンにすると、一致する URL が含まれているモジュールの取得にユーザー名とパスワードが使用されます。

[コンテナーの作成オプション] ボックスに、Edge 共有と Edge ローカル共有に関する前の手順でコピーした Edge モジュールに対するローカルマウントポイントを入力します。

重要

ここで使用するパスはコンテナーにマウントされるので、コンテナーの機能で必要なものと一致する必要があります。カスタムモジュールの作成に関する記事に従っている場合、そのモジュール内で指定されているコードではコピーされたパスが必要です。これらのパスを変更しないでください。

[コンテナーの作成オプション] ボックスで、次のサンプルを貼り付けることができます。

{
  "HostConfig": 
  {
   "Binds": 
    [
     "/home/hcsshares/mydbesmbedgelocalshare1:/home/input",
     "/home/hcsshares/mydbesmbedgeshare1:/home/output"
    ]
   }
}

ご自分のモジュールに使用される環境変数を指定します。環境変数では、ご自分のモジュールが実行される環境の定義に役立つオプション情報を指定します。

The Container Create Options box

必要に応じて、Edge ランタイムの詳細設定を構成し、 [次へ] をクリックします。

[ルートの指定] で、モジュール間のルートを設定します。

route は、前にコピーした次のルート文字列に置き換えることができます。この例では、クラウド共有にデータをプッシュするローカル共有の名前を入力します。 modulename は、モジュールの名前に置き換えます。 [次へ] を選択します。
```
"route": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/filemove/inputs/input1\")"
```
[Review deployment](デプロイの確認) ですべての設定を確認してから [送信] を選択し、デプロイのためにモジュールを送信します。

このアクションにより、モジュールのデプロイが始まります。デプロイが完了すると、モジュールの [ランタイムの状態] は [実行中] になります。

データ変換を検証して転送する

最後の手順では、モジュールが接続され、想定どおりに実行されていることを確認します。モジュールのランタイムの状態は、IoT Hub リソース内のお客様の IoT Edge デバイスに対して実行中である必要があります。

データの変換を検証して Azure に転送するには、次の手順のようにします。

エクスプローラーで、先ほど作成した Edge ローカル共有と Edge 共有の両方に接続します。
データをローカル共有に追加します。

そのデータはクラウド共有に移動されます。

データは次に、クラウド共有からストレージアカウントにプッシュされます。データを表示するには、ストレージアカウントに移動してから、 [Storage Explorer] を選択します。ストレージアカウントにアップロードされたデータを見ることができます。