IoT Edge を更新する

Linux x64 デバイスでは、apt-get または適切なパッケージ マネージャーを使って、ランタイム モジュールを最新バージョンに更新します。

apt を更新します。

sudo apt-get update

使用できる IoT Edge のバージョンを確認します。

apt list -a iotedge

最新バージョンのランタイム モジュールに更新する場合は、次のコマンドを使います。これにより libiothsm-std も最新バージョンに更新されます。

sudo apt-get install iotedge

特定のバージョンのランタイム モジュールに更新する場合は、apt リスト出力からバージョンを指定します。 iotedge が更新されるたびに、libiothsm std パッケージの最新バージョンへの更新が自動的に試行されます。これにより、依存関係の競合が発生する可能性があります。 最新バージョンに移行しない場合は、必ず同じバージョンの両方のパッケージをターゲットにしてください。 たとえば、次のコマンドでは、1.1 リリースの特定のバージョンがインストールされます。

sudo apt-get install iotedge=1.1.1 libiothsm-std=1.1.1

インストールするバージョンが apt によって使用できない場合は、curl を使用することで、IoT Edge リリース リポジトリからの任意のバージョンをターゲットにすることができます。 インストールするバージョンに応じて、ご利用のデバイスに適した libiothsm-std および iotedge ファイルを見つけます。 ファイルごとに、ファイル リンクを右クリックして、リンクのアドレスをコピーします。 リンクのアドレスを使用して、それらのコンポーネントの特定のバージョンをインストールします。

curl -L <libiothsm-std link> -o libiothsm-std.deb && sudo apt-get install ./libiothsm-std.deb
curl -L <iotedge link> -o iotedge.deb && sudo apt-get install ./iotedge.deb

IoT Edge バージョン 1.1 は Red Hat Enterprise Linux 8 ではサポートされていません。

IoT Edge for Linux on Windows の更新プログラムについては、EFLOW 更新プログラムに関するページを参照してください。

Windows の IoT Edge では、IoT Edge は Windows デバイスで直接実行されます。

コマンドを Update-IoTEdge 使ってモジュール ランタイムを更新します。 スクリプトにより、モジュール ランタイムの最新バージョンが自動的にプルされます。

. {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; Update-IoTEdge

Update-IoTEdge コマンドを実行すると、デバイスから 2 つのランタイム コンテナー イメージと共にランタイム モジュールが削除され更新されます。 config.yaml ファイルは、Moby コンテナー エンジンのデータと同様に、デバイス上にも保存されています。 構成情報の保持は、更新プロセス中に、接続文字列または Device Provisioning Service 情報をデバイスに再び提供する必要がないことを意味します。

特定のバージョンのセキュリティ サブシステムに更新する場合は、IoT Edge リリースから、対象となる 1.1 リリース チャネルからのバージョンを見つけます。 そのバージョンで、Microsoft-Azure-IoTEdge.cab ファイルをダウンロードします。 次に、-OfflineInstallationPath パラメーターを使用してローカル ファイルの場所を指定します。 次に例を示します。

. {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; Update-IoTEdge -OfflineInstallationPath <absolute path to directory>

デバイスをオフラインで更新する場合は、Azure IoT Edge リリースから、対象のバージョンを見つけます。 そのバージョンで、IoTEdgeSecurityDaemon.ps1 と Microsoft-Azure-IoTEdge.cab の各ファイルをダウンロードします。 各リリースの機能をサポートするために機能が変更されるため、使用する .cab ファイルと同じリリースの PowerShell スクリプトを使用することが重要です。

ダウンロードした .cab ファイルにアーキテクチャのサフィックスが付いている場合は、そのファイルの名前を Microsoft-Azure-IoTEdge.cab のみに変更します。

オフライン コンポーネントを使用して更新するには、PowerShell スクリプトのローカル コピーをドット ソースで使用します。 次に、Update-IoTEdge コマンドの一部として -OfflineInstallationPath パラメーターを使用して、ファイル ディレクトリへの絶対パスを指定します。 たとえば、 にします。

. <path>\IoTEdgeSecurityDaemon.ps1
Update-IoTEdge -OfflineInstallationPath <path>

更新オプションの詳細については、コマンド Get-Help Update-IoTEdge -full を使用するか、Windows コンテナーを使用した IoT Edge 用の PowerShell スクリプトに関するページを参照してください。

バージョン 1.2 以降、IoT Edge サービスには新しいパッケージ名が使用されるようになりました。また、インストールと構成のプロセスにいくつかの違いがあります。 バージョン 1.0 または 1.1 を実行している IoT Edge デバイスがある場合、最新リリースに更新する方法については、以下の手順を参照してください。

最新リリースとバージョン 1.1 以前の主な違いは次のとおりです。

• パッケージ名は iotedge から aziot-edge に変更されました。
• libiothsm-std パッケージは使用されなくなりました。 IoT Edge リリースの一部として提供されている標準パッケージを使用した場合は、構成を新しいバージョンに移行できます。 libiothsm-std の別の実装を使用していた場合は、デバイス ID 証明書、デバイス CA、信頼バンドルなどのユーザー指定の証明書を再構成する必要があります。
• 新しい ID サービス aziot-identity-service は、1.2 リリースの一部として導入されました。 このサービスにより、IoT Edge と、IoT Hub 用デバイスの更新などの IoT Hub と通信する必要があるその他のデバイス コンポーネントの ID のプロビジョニングと管理が処理されます。
• 既定の構成ファイルは、名前と場所が新しくなっています。 以前は /etc/iotedge/config.yaml でしたが、デバイス構成情報は既定で /etc/aziot/config.toml 内にあることが想定されています。 iotedge config import コマンドを使用すると、構成情報を以前の場所と構文から新しいものへと移行できます。
  • Import コマンドでは、デバイスのトラステッド プラットフォーム モジュール (TPM) に対するアクセス規則を検出または変更することはできません。 デバイスで TPM 構成証明を使用している場合は、/etc/udev/rules.d/tpmaccess.rules ファイルを手動で更新して、aziottpm サービスにアクセスできるようにする必要があります。 詳細については、「IoT Edge に TPM へのアクセス権を付与する」を参照してください。
• 最新バージョンのワークロード API は、暗号化されたシークレットを新しい形式で保存します。 以前のバージョンから最新バージョンにアップグレードすると、既存のマスター暗号化キーがインポートされます。 ワークロード API は、インポートした暗号化キーを使用して、以前の形式で保存されたシークレットを読み取ることができます。 ただし、ワークロード API では、暗号化されたシークレットを以前の形式で書き込むことはできません。 モジュールによって再暗号化されると、シークレットは新しい形式で保存されます。 最新バージョンで暗号化されたシークレットは、バージョン 1.1 の同じモジュールでは読み取ることができません。 暗号化されたデータをホストによってマウントされたフォルダーまたはボリュームに保持する場合は、必要に応じてダウングレードする機能を保持するために、アップグレードする前に必ずデータのバックアップ コピーを作成してください。
• TLS 1.2 をサポートしていないデバイスを接続するときの下位互換性のために、SslProtocols 環境変数を介して TLS 1.0 または 1.1 を引き続き受け入れるように Edge ハブを構成できます。 IoT Hubでの TLS 1.0 および 1.1 のサポートはレガシと見なされ、今後のリリースでも Edge ハブから削除される可能性があることに注意してください。 今後の問題を回避するには、Edge ハブまたは IoT Hub に接続するときに、TLS バージョンとして TLS 1.2 のみを使用してください。
• Edge Hub 1.2 の実験用 MQTT ブローカーのプレビューは終了しており、Edge Hub 1.3 以降には含まれていません。 受け取ったフィードバックに基づいて、MQTT ブローカーの計画を継続的に改善しています。 その間、IoT Edge で標準準拠の MQTT ブローカーが必要な場合は、Mosquitto のようなオープンソース ブローカーを IoT Edge モジュールとしてデプロイすることを検討してください。
• バージョン 1.2 以降では、バッキング イメージは、コンテナーから削除されてもコンテナーが実行され続け、再起動後も保持されます。 1.1 では、バッキング イメージが削除されると、コンテナーがすぐに再作成され、バッキング イメージが更新されます。

更新プロセスを自動化する前に、テスト マシンで機能することを確認してください。

準備ができたら、次の手順に従ってデバイスの IoT Edge を更新します。

1. apt を更新します。

   sudo apt-get update
   

2. 構成ファイルをそのままにして、以前のバージョンの IoT Edge をアンインストールします。

   sudo apt-get remove iotedge
   

3. 最新バージョンの IoT Edge を、Edge 用の IoT ID サービスと Microsoft Defender for IoT マイクロ エージェントと共にインストールします。

   sudo apt-get install aziot-edge defender-iot-micro-agent-edge
   

Edge デバイスのセキュリティ監視とセキュリティ強化を有効にするには、Edge エージェントを使ってマイクロ エージェントをインストールすることをお勧めします。 Microsoft Defender for IoT の詳細については、「デバイス ビルダー向け Microsoft Defender for IoT とは」を参照してください。

1. 以前の config.yaml ファイルを新しい形式にインポートし、構成情報を適用します。

   sudo iotedge config import
   

IoT Edge バージョン 1.1 は Red Hat Enterprise Linux 8 ではサポートされていません。

Windows コンテナーまたは IoT Edge for Linux on Windows を使っている場合は、この特殊なケースのセクションは適用されません。

現時点では、Windows デバイスで実行されている IoT Edge バージョン 1.2 以降はサポートされません。