Azure Device Update for IoT Hub に更新プログラムをインポートする

Azure Device Update for IoT Hub を使用して更新プログラムをデバイスにデプロイするには、まず、更新プログラム ファイルを Device Update サービスにインポートします。このサービスにより、デバイスにデプロイできるように、インポートされた更新プログラムが格納されます。 この記事では、Azure portal、Azure CLI、または Device Update API を使用して、Device Update サービスに更新プログラムをインポートする方法について説明します。

前提条件

• IoT ハブで構成された Device Update アカウントとインスタンス。

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

• デバイス用の更新プログラム ファイルと、「Device Update にインポートする更新プログラムを準備する」の手順に従って作成された関連するインポート マニフェスト ファイル。

• Azure Storage アカウントと、インポートされたファイルを保持するコンテナー。 または、Azure portal ベースのインポート プロセスの一環として、新しいストレージ アカウントとコンテナーを作成することもできます。

  重要

  使用または作成するストレージ アカウントで、プライベート エンドポイントが有効になっていないことを確認します。 プライベート エンドポイントが有効になっているかどうかを確認するには、[Private Link センター] の [プライベート エンドポイント] で、使用する Azure Storage アカウント名が表示されるかどうかを確認します。

Azure Portal

• サポートされているブラウザー (Microsoft Edge または Google Chrome)。

Azure CLI

• Bash 環境。

  この記事のコマンドを実行するには、Azure Cloud Shell の Bash 環境を使用できます。 [Cloud Shell の起動] を選択して Cloud Shell を開くか、Azure portal の上部ツールバーにある Cloud Shell アイコンを選択します。

  

  または、必要に応じて、Azure CLI コマンドをローカルで実行することもできます。

  1. Azure CLI のインストール。 az version を実行して、インストールされている Azure CLI のバージョンと依存ライブラリを確認し、az upgrade を実行して最新バージョンをインストールします。
  2. az login を実行して Azure にサインインします。
  3. 初回使用時にメッセージが表示されたら、azure-iot 拡張機能をインストールします。 最新バージョンの拡張機能を使用していることを確認するには、az extension update --name azure-iot を実行します。

ヒント

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

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

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

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

Azure Portal

1. Azure portal で、お使いの Device Update インスタンスの [IoT ハブ] ページの左側にあるナビゲーションから [デバイス管理]>[更新プログラム] の順に選択します。

   

2. [更新プログラム] ページで [新しい更新プログラムのインポート] を選択します。

   

3. [更新プログラムのインポート] ページで [ストレージ コンテナー から選択] を選択します。

4. [ストレージ アカウント] ページで、既存のストレージ アカウントを選択するか、[ストレージ アカウント] を選択して新しいアカウントを作成します。 コンテナーのストレージ アカウントを使用して、更新プログラム ファイルをステージします。

5. [コンテナー] ページで、既存のコンテナーを選択するか、[コンテナー] を選択して新しいコンテナーを作成します。 コンテナーを使用して、インポート用の更新プログラム ファイルをステージングします。

   

   ヒント

   更新プログラムをインポートするたびに新しいコンテナーを使用すると、誤って以前の更新プログラムからファイルをインポートするのを防ぐことができます。 新しいコンテナーを使用しない場合は、必ず既存のコンテナーから以前のファイルを削除してください。

6. [コンテナー] ページで [アップロード] を選択します。

   

7. [BLOB のアップロード] 画面で、[ファイル] の横にあるフォルダー アイコンを選択します。 ファイル ピッカーを使用して、更新プログラム ファイルとインポート マニフェスト ファイルの場所に移動し、ファイルを選択して、[開く] を選択します。 Shift キーを使用すると、ファイルを複数選択できます。

   

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

   

9. アップロードすると、ファイルがコンテナー ページに表示されます。 コンテナー ページで、インポートするファイルを確認して選択し、[選択] を選択します。

   

10. [更新プログラムのインポート] 画面で [更新プログラムのインポート] を選択します。

    

インポート プロセスが開始され、画面が [更新プログラム] セクションに切り替わります。 インポートが成功すると、[更新プログラム] タブに表示されます。エラーを解決するには、プロキシ更新のトラブルシューティングに関するページを参照してください。

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 を使用して、更新プログラムが正常にインポートされたことを確認します。

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

Device Update API を使用してインポートする

次のいずれかの方法を使用して、プログラムで更新プログラムをインポートすることもできます。

• .NET、Java、JavaScript、または Python 用の Azure SDK 内の Device Update API
• Device Update の Import Update REST API
• サンプルの PowerShell モジュール (Linux、macOS、または Windows 用の PowerShell 5 以降が必要)

Note

必要な API アクセス許可については、Device Update のユーザー ロールとアクセスに関するページを参照してください。

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

ヒント

大きな更新プログラムを Azure Storage Blob コンテナーにアップロードする場合にパフォーマンスを向上するには、次のいずれかの方法を使用できます。

• AzCopy
• Azure Storage Explorer

関連するコンテンツ

• デバイス グループ
• Device Update のインポート マニフェスト