デバイスとグループをパブリック プレビューからパブリック プレビュー更新に移行する
Device Update for IoT Hub サービスの新しいバージョンがリリースされたら、最新の機能およびセキュリティの強化のために、デバイスを更新する必要があります。 この記事では、パブリック プレビュー リリースからパブリック プレビュー更新 (PPR) リリースに移行する方法について説明します。 この記事では、これらのリリース前後でのグループと UX の動作についても説明します。 パブリック プレビュー リリースを使用するデバイス、グループ、デプロイが存在しない場合、このページを無視してかまいません。
正常に移行するには、デバイスで実行されている DU エージェントをアップグレードする必要があります。 また、更新プログラムをデプロイおよび管理するための新しいデバイス グループを作成する必要があります。 PPR リリースには大きな変更があるため、エラーを回避するために、注意して手順に従うことをお勧めします。
デバイス更新エージェントを更新する
パブリック プレビュー更新リリースの場合、Device Update エージェントは、以下の説明に従って手動で更新する必要があります。 パブリック プレビュー リリースと PPR リリースでは大きな変更があるため、Device Update デプロイによるエージェントの更新はサポートされていません。
古いエージェント (バージョン 0.7.0/0.6.0) を使用しているデバイスと、2022 年 2 月 3 日より前に作成されたグループを表示するには、パブリック プレビュー ポータルに移動します。このポータルにはバナーからアクセスできます。
Azure portal 上に新しい IoT デバイスまたは IoT Edge デバイスを作成します。 後で使用するために、デバイス ビューからデバイスのプライマリ接続文字列をコピーします。 詳細については、デバイスを IoT Hub に追加するセクションを参照してください。
次に、デバイスに SSH 接続し、古いデバイス更新エージェントを削除します。
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 デバイスを削除します。
Note
DU デプロイを使用してエージェントを更新しようとすると、デバイスが Device Update で管理できなくなります。 デバイスを Device Update から管理するには、デバイスを再プロビジョニングする必要があります。
グループをパブリック プレビュー更新に移行する
デバイスで Device Update エージェント バージョン 0.6.0 または 0.7.0 を使用している場合は、上記の手順に従って、最新のエージェント バージョン 0.8.0 にアップグレードします。
バナーを移動して、パブリック プレビュー ポータルの既存のグループを削除します。
更新されるデバイスのデバイス ツインにグループ タグを追加します。 詳細については、「デバイスにタグを追加する」セクションを参照してください。
[グループの追加] に移動し、ドロップダウン リストから対応するグループ タグを選択して、PPR ポータルでグループを再作成します。
パブリック プレビュー ポータルのグループが削除されていない場合、PPR ポータルで同じ名前のグループを作成できないことに注意してください。
リリース前後でのグループとデプロイの動作
パブリック プレビュー更新リリース ポータルで作成されたグループでは、最新の Device Update エージェント (0.8.0) を使用したデバイスの追加のみが許可されます。 古いエージェント (0.7.0/0.6.0) を持つデバイスは、これらのグループに追加できません。
最新のエージェントを使用している新しいデバイスは、[グループとデプロイ] タブの既定の DeviceClass グループに自動的に追加されます。デバイスのプロパティにグループ タグが追加されている場合、そのタグのグループが存在すれば、デバイスはそのグループに追加されます。
最新のエージェントを使用しているデバイスの場合、グループ タグがデバイスのプロパティに追加されているが、対応するグループがまだ作成されていない場合、デバイスは [グループとデプロイ] タブに表示されません。
古いエージェントを使用しているデバイスは、グループ タグが追加されていない場合、古いポータルでグループ化されていないと表示されます。
次のステップ
次のチュートリアルを使用して、Device Update for IoT Hub の簡単なデモを実行できます。
イメージの更新: Raspberry Pi 3 B+ 参照 Yocto イメージの使用を開始することに関する記事。必要に応じて他のアーキテクチャ用の独自のイメージをビルドするために、オープン ソースを通じて拡張できます。
Azure リアルタイム オペレーティング システムでの Device Update for Azure IoT Hub のチュートリアル