Device Update for IoT Hub サービスが新しいバージョンをリリースしたら、最新の機能とセキュリティの強化のためにデバイスを更新する必要があります。 この記事では、パブリック プレビュー リリース から現在の パブリック プレビュー更新 (PPR) リリースに移行する方法について説明します。 この記事では、これらのリリース全体のグループと UX の動作についても説明します。 パブリック プレビュー リリースを使用するデバイス、グループ、および展開がない場合は、このページを無視できます。
正常に移行するには、デバイスで実行されている DU エージェントをアップグレードする必要があります。 更新プログラムを展開および管理するには、新しいデバイス グループを作成する必要もあります。 PPR リリースには大きな変更があるため、エラーを回避するために、指示に従うことをお勧めします。
デバイス更新エージェントを更新する
パブリック プレビュー更新リリースの場合、デバイス更新エージェントは、以下の説明に従って手動で更新する必要があります。 パブリック プレビューおよび PPR リリース全体で大きな変更が行われるため、Device Update の展開を介したエージェントの更新はサポートされていません。
古いエージェント (バージョン 0.7.0/0.6.0) と 2022 年 2 月 3 日より前に作成されたグループを使用してデバイスを表示するには、バナーからアクセスできるパブリック プレビュー ポータルに移動します。
Azure portal で新しい IoT/IoT Edge デバイスを作成します。 後で使用するために、デバイス ビューからデバイスのプライマリ接続文字列をコピーします。 詳細については、「デバイスを IoT Hub に追加する」 セクションを参照してください。
次に、デバイスに SSH 接続し、古い Device Update エージェントを削除します。
sudo apt remove deviceupdate-agent sudo apt remove adu-agent古い構成ファイルを削除する
sudo rm -f /etc/adu/adu-conf.txt新しいエージェントをインストールする
sudo apt-get install deviceupdate-agentまたは、GitHub から.deb資産を取得し、エージェントをインストールすることもできます。
sudo apt install <file>.deb古いエージェントと構成ファイルを削除せずに Device Update エージェントをアップグレードしようとすると、次に示すエラーが発生します。
次のコマンドを実行して、構成ファイルにお使いの IoT デバイスの主要接続文字列 (デバイスを Device Update でプロビジョニングした方法に応じてデバイスまたはモジュール) を入力してください。
sudo nano /etc/adu/du-config.jsonモデル、製造元、エージェント名、接続の種類、その他の詳細を構成ファイルに追加する
パブリック プレビュー ポータルから古い IoT/IoT Edge デバイスを削除します。
注
DU 展開を使用してエージェントを更新しようとすると、デバイスは Device Update で管理できなくなります。 Device Update から管理するには、デバイスを再プロビジョニングする必要があります。
グループをパブリック プレビュー更新に移行する
デバイスで Device Update エージェント バージョン 0.6.0 または 0.7.0 を使用している場合は、上記の手順に従って最新のエージェント バージョン 0.8.0 にアップグレードします。
バナー内を移動して、パブリック プレビュー ポータルで既存のグループを削除します。
更新されたデバイスのデバイス ツインにグループ タグを追加します。 詳細については、「デバイスにタグを追加する」セクションを参照してください。
[グループの追加] に移動し、ドロップダウン リストから対応するグループ タグを選択して、PPR ポータルでグループを再作成します。
パブリック プレビュー ポータルのグループが削除されていない場合、PPR ポータルで同じ名前のグループを作成できないことに注意してください。
リリース間でのグループ化と展開の動作
パブリック プレビュー更新リリース ポータルで作成されたグループでは、最新のデバイス更新エージェント (0.8.0) を使用したデバイスの追加のみが許可されます。 古いエージェント (0.7.0/0.6.0) を持つデバイスをこれらのグループに追加することはできません。
最新のエージェントを使用する新しいデバイスは、[グループと展開] タブの既定の DeviceClass グループに自動的に追加されます。グループ タグがデバイスのプロパティに追加された場合、そのタグのグループが存在する場合、デバイスはそのグループに追加されます。
最新のエージェントを使用しているデバイスの場合、グループ タグがデバイスのプロパティに追加されているが、対応するグループがまだ作成されていない場合、デバイスは [グループと展開] タブに表示されません。
古いエージェントを使用しているデバイスは、グループ タグが追加されていない場合、古いポータルでグループ化解除済みとして表示されます。
次のステップ
Device Update for IoT Hub の簡単なデモンストレーションには、次のチュートリアルを使用できます。
イメージの更新: Raspberry Pi 3 B+ Reference Yocto Image を使用した開始方法、必要に応じて他のアーキテクチャ用の独自のイメージを作成するためにオープンソースを通じて拡張可能です。
Ubuntu (18.04 x64) シミュレーター参照エージェント の使用を開始する
Azure-Real-Time-Operating-System 用の Azure IoT Hub の Device Update チュートリアル