Device Update for IoT Hub に更新プログラムを追加する

新しい更新プログラムを取得して、Device Update for IoT Hub にインポートする方法について説明します。 まだ行っていない場合は、鍵となるインポートの概念およびインポートする更新プログラムを準備する方法を確認してください。

前提条件

• Device Update for IoT Hub が有効になっている IoT Hub にアクセスできること。

• プライベート エンドポイントが有効になって "いない" Azure Storage コンテナー。

  • プライベート エンドポイントが有効になっているかどうかわからない場合は、Private Link センターに移動し、左側の [プライベート エンドポイント] を選択し、[リソース] 列で Azure Storage アカウント名を探します。

• Device Update 用にプロビジョニングされている、IoT Hub 内の IoT デバイス (またはシミュレーター)。

• 「Device Update for IoT Hub にインポートする更新を準備する」の手順に従って、更新ファイルのインポート マニフェストを作成します。

Azure Portal

サポートされているブラウザー:

• Microsoft Edge
• Google Chrome

Azure CLI

Azure CLI 環境:

• Azure Cloud Shell で Bash 環境を使用します。

  

• CLI リファレンス コマンドをローカルで実行する場合、Azure CLI をインストールします

  1. az login コマンドを使用して、Azure CLI にサインインします。
  2. az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。 最新バージョンにアップグレードするには、az upgrade を実行します。
  3. 初回使用時に確認を求められたら、Azure CLI 拡張機能をインストールします。 この記事のコマンドでは、azure-iot 拡張機能を使います。 az extension update --name azure-iot を実行して、最新バージョンの拡張機能を使用していることを確認してください。

ヒント

この記事の Azure CLI コマンドでは、行の継続に円記号 \ を使用して、コマンド引数を読みやすくします。 この構文は、Bash 環境で機能します。 PowerShell でこれらのコマンドを実行している場合は、各円記号をバックティック (`) に置き換えるか、完全に削除します。

更新プログラムのインポート

このセクションでは、Azure portal または Azure CLI を使用して更新プログラムをインポートする方法について説明します。 代わりに、Device Update for IoT Hub の API を使用して、更新プログラムをインポートすることもできます。

更新プログラムをインポートするには、最初に更新ファイルをアップロードし、マニフェストを Azure Storage コンテナーにインポートします。 次に、更新プログラムを Azure Storage から Device Update for IoT Hub にインポートします。ここで、更新プログラムがデバイスにデプロイするために格納されます。

Azure Portal

1. Azure portal で、Device Update がある IoT Hub に移動します。

2. ページの左側で、[デバイス管理] の下にある [更新プログラム] を選択します。

   

3. 画面の上部にあるタブの一覧から [更新プログラム] タブを選択します。

   

4. [利用可能な更新プログラム] ヘッダーの下にある [+ 新しい更新プログラムのインポート] を選択します。

   

5. [+ ストレージ コンテナーから選択] を選択します。 [ストレージ アカウント] の UI が表示されます。 [+ ストレージ アカウント] を使用して、既存のアカウントを選択するか、アカウントを作成します。 このアカウントは、インポート用に更新をステージするためにコンテナーで使用されます。 アカウントでは、パブリック エンドポイントとプライベート エンドポイントの両方を同時に有効にしないでください。

   

6. ストレージ アカウントを選択すると、[コンテナー] の UI が表示されます。 既存のコンテナーを選択するか、[+ コンテナー] を使用してコンテナーを作成します。 このコンテナーは、インポートの場合に更新ファイルをステージするために使用されます

   更新プログラムをインポートするごとに新しいコンテナーを使用することをお勧めします。 常に新しいコンテナーを使用すれば、以前の更新プログラムからのファイルを誤ってインポートするのを防ぐことができます。 新しいコンテナーを使用しない場合は、この手順を完了する前に、既存のコンテナーからファイルを削除してください。

   

7. コンテナーで [更新] を選択します。 アップロードの UI が表示されます。

   

8. [BLOB のアップロード] ヘッダーの下にある [ファイル] セクションの右側にあるフォルダー アイコンを選択します。 ファイル ピッカーを使用して、更新ファイルとインポート マニフェストの場所に移動し、すべてのファイルを選択して、[開く] を選択します。 "Shift キーを押しながらクリックすると、複数のファイルを選択できます。"

   

9. すべての更新ファイルを選択した後、[アップロード] を選択します。

   

10. アップロードされたファイルを選択して、インポートするように指定します。 続いて [選択] ボタンを選択して、[更新プログラムのインポート] ページに戻ります。

    

11. [更新プログラムのインポート] ページで、インポートするファイルを確認します。 次に、[更新プログラムのインポート] を選択してインポート プロセスを開始します。 エラーを解決するには、プロキシ更新のトラブルシューティングに関するページを参照してください。

    

12. インポート プロセスが開始され、画面が [インポートの履歴] セクションに切り替わります。 インポート処理が完了するまでの進行状況を表示するには、[更新] を選択します (更新プログラムのサイズによっては、プロセスは数分で完了することも、長時間かかることもあります)。

    

13. [状態] 列にインポートが正常に完了したことが表示されたら、[使用可能な更新プログラム] ヘッダーを選択します。 インポートされた更新プログラムが一覧に表示されるはずです。

    

Azure CLI

az iot du update stage コマンドを使用すると、更新ファイルをターゲット ストレージ コンテナーにアップロードするなど、更新プログラムをインポートするための前提条件の手順が処理されます。 オプションのフラグを指定すると、このコマンドでは、準備が整ったファイルを自動的にインポートします。 それ以外の場合、このプロセスは az iot du update import コマンドによって完了されます。

stage コマンドは次の引数を使用します。

• --account: Device Update アカウント名。
• --instance: デバイス更新インスタンス名。
• --manifest-path: ステージする必要があるインポート マニフェストへのファイル パス。
• --storage-account: 更新をステージするストレージ アカウントの名前。
• --storage-container: 更新をステージする、選択したストレージ アカウント内のコンテナーの名前。
• --overwrite: 競合がある場合にストレージ コンテナー内の既存の BLOB を上書きするかどうかを示す省略可能なフラグ。
• --then-import: 更新プログラムがステージされた後に、それを Device Update にインポートするかどうかを示す省略可能なフラグ。

az iot du update stage \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    --manifest-path <Replace with the full path to your import manifest> \
    --storage-account <Replace with your Storage account name> \
    --storage-container <Replace with your container name> \
    --overwrite --then-import

次に例を示します。

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/file.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

複数のインポート マニフェストがある場合は、それらすべてを 1 つのコマンドに含めることができます。 次に例を示します。

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/parent.importmanifest.json \
    --manifest-path /my/apt/manifest/child1.importmanifest.json \
    --manifest-path /my/apt/manifest/child2.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

--then-import フラグを使用しない場合、stage コマンドの出力には、事前に設定された引数を含む az iot du update import を実行するためのプロンプトが含まれます。

az iot du update list を使用して、1 つまたは複数の更新プログラムが正常にインポートされたことを確認します。

az iot du update list \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    -o table

代わりに API を使用してインポートしている場合

次の方法により、プログラムで更新プログラムをインポートすることもできます。

• .NET、Java、JavaScript、Python 用の Azure SDK を使用する
• Import Update REST API を使用する
• サンプルの PowerShell モジュールを使用する
  • PowerShell 5 以降 (Linux、macOS、Windows のインストールを含む)

Note

必要な API アクセス許可については、デバイス更新のユーザー ロールとアクセス権に関する記事を参照してください。

更新ファイルとインポート マニフェストは、ステージング用に Azure Storage Blob コンテナーにアップロードする必要があります。 ステージングされたファイルをインポートするには、BLOB の URL、またはプライベート BLOB の Shared Access Signature (SAS) を Device Update API に提供します。 SAS を使用する場合は、必ず 3 時間以上の有効期限を指定してください

ヒント

大量の更新ファイルを Azure Storage Blob コンテナーにアップロードするには、次のいずれかを使用してパフォーマンスを向上させることができます。

• AzCopy
• Azure Storage Explorer

次の手順

• グループを作成する
• インポートの概念について学習する