Device Update for Azure IoT Hub を使用して更新プログラムを展開します。

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

• Microsoft Edge
• Google Chrome

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 を実行して、最新バージョンの拡張機能を使用していることを確認してください。

1. Azure Portal で、IoT ハブに移動します。

2. ナビゲーション メニューから [更新プログラム] を選択して、IoT Hub インスタンスの [デバイスの更新] ページを開きます。

   

3. ページの上部にある [グループとデプロイ] タブを選択します。 詳細については、「デバイス グループ」を参照してください。

   

4. 更新プログラムのコンプライアンス チャートとグループの一覧を表示します。 タグ ベースまたは既定のグループで使用できる新しい更新プログラムが表示されます。 場合によっては、一度最新の情報に更新する必要があります。 詳細については、「デバイス更新のコンプライアンス」を参照してください。

5. 使用可能な 1 つ以上の更新プログラムの横にある [デプロイ] を選択し、インポート時に追加したわかりやすいラベルが存在していることと、正しく表示されていることを確認します。

6. 対象のグループとして正しいグループが選択されていることを確認し、[デプロイ] を選択します。

7. デプロイを開始するには、[現在のデプロイ] タブに移動します。[使用できる更新プログラム] セクションで、目的の更新プログラムの横にある [デプロイ] リンクを選択します。 特定のグループに最適な使用可能な更新プログラムには、最適 の強調表示が付けられます。

   

8. デプロイを直ちに開始するか、後で開始するようにスケジュールします。

   ヒント

   既定では、開始の日時は [今すぐ] に設定されます。 デプロイを後で開始したい場合は、異なる日時を選択してください。

   

9. 必要に応じて、自動ロールバック ポリシーを作成します。 [作成] を選択します。

10. [デプロイの詳細] で、[状態] が [アクティブ] に変わります。 デプロイされた更新プログラムには (デプロイ中) のマークが付きます。

    

11. コンプライアンス チャートを表示して、更新が進行中であることを確認します。

    

12. デバイスが正常に更新されると、コンプライアンス チャートとデプロイの詳細が、同じ内容を反映するように更新されていることがわかります。

    

グループに最適な更新プログラムを確認するには、az iot du device group list を使用します。 このコマンドには、次の引数を使用できます。

• --account: Device Update アカウント名。
• --instance: デバイス更新インスタンス名。
• --group-id: このデプロイの対象とするデバイス グループ ID。 この ID は、ADUGroup タグの値です (タグのないデバイスの場合は $default です)。
• --best-updates: このフラグを指定すると、対象のデバイス グループに利用可能な最適の更新プログラムを取得するようコマンドに指示します。たとえば、各更新プログラムを必要とするデバイスの数が含まれます。
• `--resource-group -g': Device Update アカウントのリソース グループ名。
• '--update-compliance': このフラグは、最新のアップデートが適用されているデバイスの数、新しいアップデートが必要なデバイスの数、新しいアップデートの受信が進行中のデバイスの数など、対象のデバイス グループの更新プログラムのコンプライアンス情報を取得するようコマンドに指示します。

az iot du device group list \
    --account <Device Update account name> \
    --instance <Device Update instance name>\
    --gid <device group id>\
    --best-updates {false, true}

az iot du device deployment create を使用して、デバイス グループのデプロイを作成します。

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

• --account: Device Update アカウント名。
• --instance: デバイス更新インスタンス名。
• --group-id: このデプロイの対象とするデバイス グループ ID。 この ID は、ADUGroup タグの値です (タグのないデバイスの場合は $default です)。
• --deployment-id: このデプロイを識別する ID。
• --update-name、 --update-provider、および --update-version: これら 3 つのパラメーターは、このデプロイで使用する更新プログラムの一意の識別子である、updateId オブジェクトを定義します。

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version>

省略可能な引数を使用すると、デプロイを構成できます。 完全な一覧については、「省略可能なパラメーター」を参照してください

自動ロールバック ポリシーを作成する場合は、次のパラメーターを追加します。

• --failed-count: ロールバックをトリガーするデプロイでの、失敗したデバイスの数。
• --failed-percentage: ロールバックをトリガーするデプロイでの、失敗したデバイスの割合。
• --rollback-update-name、--rollback-update-provider、--rollback-update-version: ロールバックが開始された場合にデバイス グループによって使用される更新プログラムの updateID。

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --failed-count 10 \
    --failed-percentage 5 \
    --rollback-update-name <rollback update name> \
    --rollback-update-provider <rollback update provider> \
    --rollback-update-version <rollback update version>

デプロイを後で開始する場合は、--start-time パラメーターを使用して、デプロイのターゲット日時を指定します。

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --start-time "2022-12-20T01:00:00"

1. デプロイ先のグループを選択し、[現在の更新プログラム] タブまたは [デプロイ履歴] タブに移動して、デプロイが進行中であることを確認します

   

2. 作成したデプロイの横にある [詳細] を選択します。 ここでは、デプロイの詳細、更新プログラムの詳細、ターゲット デバイス クラスの詳細を確認できます。 必要に応じて、デバイス クラスのフレンドリ名を追加することもできます。

   

3. [最新の情報に更新] を選択して、最新の状態の詳細を表示します。

4. グループの基本ビューに移動すると、特定のデバイスの状態を検索したり、フィルター処理してデプロイに失敗したデバイスを表示したりできます

デバイス グループのすべてのデプロイを表示するには、az iot du device deployment list を使用します。

az iot du device deployment list \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id>

特定のデプロイの詳細を表示するには、az iot du device deployment show を使用します。

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID>

--status フラグを追加すると、デプロイが進行中のデバイス、完了したデバイス、または失敗したデバイスの数に関する情報が返されます。

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --status

1. [グループの詳細] スクリーンで [現在のデプロイ] タブに移動します。

   

2. [失敗したデバイスの再試行] を選択し、確認通知に同意します。

デバイスのターゲット サブグループのデプロイを再試行するには、az iot du device deployment retry を使用します。

このコマンドは、--class-id 引数を受け取ります。これは、デバイス更新エージェントによって報告されたモデル ID と互換性プロパティから生成されます。

az iot du device deployment retry \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --deployment-id <deployment ID> \
    --group-id <device group ID> \
    --class-id <device class ID>