ソフトウェアアップデートをインポートする(プレビュー)

デバイスグループや名前空間にオンボードするデバイスにソフトウェアアップデートを展開する前に、まずAzureデバイスレジストリの名前空間にアップデートをインポートする必要があります。 各ソフトウェアアップデートは、1つ以上のアップデートファイルとインポートマニフェストで構成されています。 インポートマニフェストには更新プログラムの識別情報、対応デバイス、インストール方法が記載されているため、Azureデバイスレジストリはその更新プログラムがどのデバイスに適用されるかを把握できます。

この記事では、Azure Storageコンテナから名前空間にソフトウェアアップデートをインポートする方法と、不要になったインポート済みアップデートを削除する方法を紹介します。

Important

Azure デバイス レジストリのソフトウェア更新機能は、現在プレビュー版として提供されています。 現在のプレビューはIoT Hub接続デバイスに限定されています。 このプレビューはサービスレベル契約なしで提供されており、一般公開前に機能やポータル体験が変わる可能性があります。 詳細については、「 Microsoft Azure プレビューの追加使用条件」を参照してください。

Prerequisites

  • 有効な Azure サブスクリプション。 お持ちでない場合は、 無料アカウントを作成してください。
  • ソフトウェアアップデートを有効にしたAzureデバイスレジストリ名前空間です。 名前空間を作成しソフトウェアアップデートを有効にするには、「Azureデバイスレジストリで始める」をご覧ください。
  • ストレージ アカウント内の更新ファイルを読み取るためのアクセス許可 (Storage Blob 共同作成者ロールなど)。
  • 名前空間にリンクされたソフトウェア更新インスタンスの デバイス更新コンテンツ管理者 ロールなど、名前空間にソフトウェア更新をインポートするためのアクセス許可
  • 更新ファイルとインポートマニフェストを格納するコンテナを持つAzure Storageアカウント:
    • アップデートファイル: イメージ、パッケージ、スクリプトなど、ご利用のデバイスにインストールされるファイル (.swu や .sh など) です。
    • インポートマニフェスト:更新を説明する拡張子 .importmanifest.json のJSONファイル。 すべてのソフトウェアアップデートはインポートマニフェストが必要です。 作成方法を学びたい方は、「インポートの更新準備」と「インポート マニフェスト スキーマ」をご覧ください。

ご利用の名前空間で「ソフトウェアの更新」に移動します

  1. Azureポータルで、Azureデバイスレジストリの名前空間に移動します。
  2. リソース メニューの 「Operations」 の下の 「Software updates (preview)」 を選択してください。
  3. ソフトウェア更新 (プレビュー) ページで、インポート タブを選択して、すでに名前空間にインポートされたソフトウェア更新を確認できます。

まだアップデートをインポートしていない場合は、ページに「 表示するアップデートなし」と表示されます。

ソフトウェアアップデートをインポートする

  1. ソフトウェア アップデート (プレビュー)で + インポートを選択します。

  2. ソフトウェアアップデートのインポートで、ファイル選択の「+ファイル追加」を選択します。

    Add filesコマンドがある「ソフトウェア更新のインポート」ページのスクリーンショットです。

  3. 更新ファイルが入っているストレージ アカウントを選択し、次へを選択します。

  4. 更新ファイルを含むコンテナを選択し、次へを選択します。

  5. 「ファイル選択」で、インポートしたい更新ファイルとインポートマニフェストファイル(拡張子は.importmanifest.json)を選択します。

    ストレージコンテナで更新ファイルとインポート マニフェスト ファイルが選択されているスクリーンショットです。

  6. ファイルピッカーを閉じて「 ソフトウェアアップデートのインポート」に戻してください。

  7. 説明ボックスで、更新の説明を入力できます。

  8. マルウェア スキャンで、更新ファイルをインポートする前に既知のマルウェアの有無を確認する場合は、更新ファイルのマルウェア スキャンを選択してください。 マルウェアスキャンは一部の地域で利用可能です。

  9. インポートを選択します。

インポートが成功すると、その更新内容は、名前、プロバイダー、バージョン、説明とともに、インポート リストに表示されます。 ソフトウェアアップデートジョブやオンボーディングアップデートジョブを使ってデプロイできます。

不足しているインポート マニフェストを修正してください

インポートマニフェストなしで ファイルを更新 すると、「 インポートマニフェストが見つかりませんでした」というメッセージでインポートが失敗します。

  1. ソフトウェアアップデートのインポートページのエラーバナーを確認してください。 インポート マニフェスト ファイルの拡張子は .importmanifest.json であることを喚起します。
  2. ストレージ コンテナーへの更新内容を記述したインポート マニフェストを追加します。
  3. 「ファイルを置き換え」を選択し、その後、更新ファイルとインポート マニフェストを選択します。
  4. 再度 インポート を選択してください。

Note

このプレビューでは、Azureポータル内でインポートマニフェストを作成または編集することはできません。 アップデートをインポートする前にインポートマニフェストを作成してください。

親および子の更新をインポート

インポートマニフェストは他の更新を参照することができます。 例えば、親アップデートは1つ以上の子アップデートを参照し、それらを一緒にまたは特定の順序でインストールする必要があります。 親アップデートとその子更新をインポートすると、 インポート リストには親アップデートとその子更新が表示されます。

インポートされた親アップデートとその子アップデートのスクリーンショットです。

Note

このプレビューでは、統合された Azure IoT SDK のソフトウェア更新クライアントが他の更新を参照する更新プログラムをインストールしません。 ソフトウェアアップデートクライアントを使用するデバイスに展開するには、インポートマニフェストが子更新を参照していないアップデートをインポートしてください。 詳細については、「プレビューの制限事項」を参照してください。

ソフトウェアアップデートを削除してください

インポートした更新が不要な場合は、名前空間から削除できます。

  1. ソフトウェアアップデート(プレビュー)ページで「インポート」タブを選択してください。
  2. 削除したいアップデートの隣にあるチェックボックスを選択してください。
  3. を選択して、を削除します。
  4. メッセージが表示されたら、[ 削除 ] を選択して確定します。

ソフトウェアアップデートを削除しても、そのアップデートをすでにインストールしたデバイスには影響しません。 しかし、新しいジョブではこのアップデートを使えなくなりました。