チュートリアル: Device Update for Azure IoT Hub を使用してプロキシの更新を完了する

[アーティクル]
1/26/2022

まだの場合は、「Device Update for Azure IoT Hub によるプロキシ更新の使用」を参照してください。

テストデバイスまたは仮想マシンのセットアップ

このチュートリアルでは、例として Ubuntu Server 18.04 LTS 仮想マシン (VM) を使用します。

Device Update のエージェントと依存関係をインストールする

APT パッケージリポジトリに packages.microsoft.com を登録します。

sudo apt-get update

sudo apt install curl

curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ~/microsoft-prod.list

sudo cp ~/microsoft-prod.list /etc/apt/sources.list.d/

curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > ~/microsoft.gpg

sudo cp ~/microsoft.gpg /etc/apt/trusted.gpg.d/

sudo apt-get update

IoT デバイスに deviceupdate-agent をインストールします。 packages.microsoft.com から、Device Update の最新の Debian ファイルをダウンロードします。
```
sudo apt-get install deviceupdate-agent
```
あるいは、ダウンロードした Debian ファイルをテスト VM にコピーします。お使いのコンピューターで PowerShell を使用している場合は、次のシェルコマンドを実行します。
```
  scp <path to the .deb file> tester@<your vm's ip address>:~
```
その後、VM にリモートでログインし、"ホーム" フォルダーで次のシェルコマンドを実行します。
```
      #go to home folder 
      cd ~
      #install latest Device Update agent
      sudo apt-get install ./<debian file name from the previous step>
```
Azure IoT Hub にアクセスして、IoT デバイスのデバイス更新モジュールのプライマリ接続文字列をコピーします。 du-config. json ファイルで、connectionData フィールドの既定値を、このプライマリ接続文字列で置き換えます。
```
   sudo nano /etc/adu/du-config.json  
```
注意

代わりに、デバイスのプライマリ接続文字列をコピーすることができますが、デバイス更新モジュールの文字列を使用することをお勧めします。モジュールの設定の詳細については、「デバイス更新エージェントのプロビジョニング」を参照してください。

/etc/adu/du-diagnostics-config.json にログ収集の正しい設定が含まれていることを確認します。次に例を示します。

{
  "logComponents":[
    {
      "componentName":"adu",
       "logPath":"/var/log/adu/"
    },
    {
      "componentName":"do",
      "logPath":"/var/log/deliveryoptimization-agent/"
    }
  ],
  "maxKilobytesToUploadPerLogPath":50
}

デバイス更新エージェントを再起動します。
```
sudo systemctl restart adu-agent
```

モックコンポーネントを設定する

テストとデモを目的として、デバイス上に以下のモックコンポーネントを作成します。

3 つのモーター
2 つのカメラ
"hostfs"
"rootfs"

重要

前記のコンポーネント構成は、libcontoso-component-enumerator.so という名前のサンプルのコンポーネント列挙子拡張機能の実装に基づいています。このモックコンポーネントのインベントリデータファイル /usr/local/contoso-devices/components-inventory.json も必要です。

demo フォルダーをテスト VM のホームディレクトリにコピーします。その後、次のコマンドを実行して、必要なファイルを適切な場所にコピーします。
```
`~/demo/tools/reset-demo-components.sh` 
```
reset-demo-components.sh コマンドによって、以下の手順が自動的に実行されます。
1. components-inventory.json がコピーされ、/usr/local/contoso-devices フォルダーに追加されます。
2. Contoso のコンポーネント列挙子拡張機能 (libcontoso-component-enumerator.so) が Assets フォルダーからコピーされ、/var/lib/adu/extensions/sources フォルダーに追加されます。
3. この拡張機能が登録されます。
```
sudo /usr/bin/AducIotAgent -E /var/lib/adu/extensions/sources/libcontoso-component-enumerator.so
```
次のコマンドを使用して現在のコンポーネントのソフトウェアバージョンを表示して記録し、プロキシの更新をサポートするように VM を設定します。
```
~/demo/show-demo-components.sh
```

サンプルの更新プログラムをインポートする

まだ Device Update のアカウントとインスタンスを作成していない場合は作成します (IoT ハブの構成を含む)。その後、以下の手順を開始します。

最新のデバイス更新プログラムのリリースの [Assets] の下から、プロキシの更新プログラムのインポートマニフェストとイメージをダウンロードします。
Azure portal にサインインし、Device Update がある IoT Hub に移動します。左側のペインで、[デバイス管理]>[更新] を選択します。
[更新] タブを選択します。
[+ 新しい更新プログラムのインポート] を選択します。
[+ ストレージコンテナーから選択] を選んでから、ストレージアカウントとコンテナーを選択します。
[アップロード] を選択し、手順 1. でダウンロードしたファイルを追加します。
親のインポートマニフェスト、子のインポートマニフェスト、およびペイロードファイルをコンテナーにアップロードします。

下記の例では、スマート掃除機デバイスに接続されているカメラを更新するためにアップロードされるサンプルファイルを示します。無線での更新の前にカメラをオフにする、インストール前スクリプトも含まれています。

この例では、親のインポートマニフェストは contoso.Virtual-Vacuum-virtual-camera.1.4.importmanifest.json です。カメラを更新するための詳細が含まれる子のインポートマニフェストは、Contoso.Virtual-Vacuum.3.3.importmanifest.json です。マニフェストファイル名はどちらも、必要な形式に従っており、末尾が .importmanifest.json になっています。
[選択] を選択します。
UI に、デバイスの更新プログラムにインポートされるファイルの一覧が表示されます。 [更新のインポート] を選択します。
インポートプロセスが開始され、画面が [インポートの履歴] セクションに変わります。 [更新] を選択すると、インポートプロセスが終了するまで進行状況が表示されます。インポートは、更新プログラムのサイズに応じて、数分で終了することも、より長い時間がかかることもあります。
[状態] 列に、インポートが成功したことが示されたら、[使用可能な更新プログラム] タブを選択します。これで、インポートされた更新プログラムが表示されるはずです。

更新プログラムのインポートについて詳しくは、こちらをご覧ください。

更新プログラムグループを作成する

ページの上部にある [グループとデプロイ] タブに移動します。
[グループの追加] ボタンを選択して、新しいグループを作成します。
一覧から IoT Hub タグおよびデバイスクラスを選択し、[グループの作成] を選択します。
グループを作成すると、更新プログラムのコンプライアンスチャートとグループの一覧が更新されていることを確認できます。更新プログラムのコンプライアンスチャートには、さまざまなコンプライアンス対応状態 (最新の更新状態、利用可能な新しい更新プログラムがある、更新プログラムのインストールが進行中) にあるデバイスの数が表示されます。更新プログラムのコンプライアンスについて説明します。
新しく作成したグループと、新しいグループ内のデバイスで利用可能な更新プログラムが表示されます。グループのデバイスクラスの要件を満たしていないデバイスがある場合は、対応する無効なグループに表示されます。グループの横にある [Deploy](デプロイ) ボタンをクリックすると、このビューから新しいユーザー定義グループに最適な更新プログラムをデプロイできます。

タグの追加と更新プログラムグループの作成に関する詳細情報

更新プログラムをデプロイする

グループが作成されると、デバイスグループで利用可能な新しい更新プログラムが表示され、[最適な更新プログラム] の下にその更新プログラムへのリンクが表示されます (一度更新する必要がある場合があります)。更新プログラムのコンプライアンスの詳細についてはこちらを参照してください。
グループ名をクリックして、ターゲットグループを選択します。 [グループの基本] の下にグループの詳細が表示されます。