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 list 出力からバージョンを指定します。 iotedge が更新されるたびに、libiothsm-std パッケージが最新バージョンに自動的に更新され、依存関係の競合が発生する可能性があります。 最新バージョンに移行しない場合は、両方のパッケージを同じバージョンに設定してください。 たとえば、次のコマンドを実行すると、特定のバージョンの 1.1 リリースがインストールされます。

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

インストールするバージョンが apt-get で使用できない場合は、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 更新プログラムに関するページを参照してください。

IoT Edge for Windows では、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、信頼バンドルなどのユーザー指定の証明書を再構成する必要があります。
• 1.2 リリースの一部として、新しい ID サービス aziot-identity-service が導入されました。 このサービスは、IoT Edge および IoT Hub との通信が必要な他のデバイス コンポーネント (Device Update for 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 Hub を構成できます。 IoT Hub での TLS 1.0 と 1.1 のサポートはレガシと見なされ、今後のリリースで Edge Hub からも削除される可能性があることに注意してください。 今後の問題を回避するには、Edge Hub または IoT Hub に接続するときに、TLS 1.2 を唯一の TLS バージョンとして使用してください。
• 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 を、IoT ID サービスと Microsoft Defender for IoT Micro Agent for Edge と共にインストールします。

   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 以降はサポートされません。