クラウド デプロイを作成する

  • [アーティクル]

クラウドからアプリケーションをデプロイするには、アプリケーション イメージを Azure Sphere カタログにアップロードし、Azure Sphere デバイスにイメージを配布するデプロイを作成します。 デプロイを作成するには、Azure Sphere にサインインし、管理者ロールが必要です。 さらに、クラウドデプロイを受け取るためにデバイスを準備する必要があります。

有効にするには、デプロイが次の規則に従う必要があります。

  • デプロイの合計サイズは 1 MiB 未満にする必要があります。
  • デプロイには、複数のボード構成ファイルを使用することはできません。

デバイスの準備

デバイスは、クラウドからアプリケーションを受信する前に、製品を持ち、デバイス グループに属している必要があり、 AppDevelopment 機能 をインストールすることはできません。

デバイス用の製品をまだ作成していない場合は、デプロイを作成する前に作成する必要があります。 製品を作成するには:

ポータルを使用する

    • Azure Portal にサインインします。
    • Azure Sphere サービスを見つけるには、上部の検索バーで「 Azure Sphere」と入力して選択します。 [Azure Sphere] ページが表示されます。
  2. デプロイを作成するカタログを選択します。 サブスクリプション フィルターが適切に設定されていることを確認して、すべてのカタログとリソース グループを表示します。
  3. カタログ ページの左側にある [製品の管理>] を選択します。
  4. カタログ ページの上部にある [ + 作成 ] をクリックします。
  5. 製品の名前と説明を入力します。 既定のデバイス グループを作成するかどうかを示すチェック ボックスをオンにします。 マークされている場合、開発、フィールド テスト、フィールド テスト OS 評価、運用、運用 OS 評価の既定のデバイス グループが作成されます。
  6. 最後に、ページの下部にある [ 作成 ] をクリックします。

既定のデバイス グループを作成しないことを選択した場合は、デバイス グループを手動で作成し、製品に関連付ける必要があります。

  1. ページの左側にある [デバイス グループの管理>] を選択します。
  2. ページの上部にある [ + 作成 ] をクリックします。
  3. 上記の手順で作成した製品を選択します。
  4. デバイス グループの名前と簡単な説明を入力します。
  5. デバイス グループのオペレーティング システム (OS) フィードを選択します。 RetailEval フィードは、Retail フィードの前にプレリリース OS バージョンを受け取ります。 そのため、 RetailEval は運用環境のデバイスには推奨されません。 実稼働デバイスの 小売 フィードを選択します。
  6. デバイス グループの更新ポリシーを選択します。 UpdateAll は、グループ内のデバイスで OS とアプリケーションの更新プログラムが利用可能になったときに実行されることを意味します。 No3rdPartyAppUpdates は、グループ内のデバイスが OS 更新プログラムのみを受け取ることを意味します。

CLI を使用する

ヒント

サブスクリプション、リソース グループ、およびカタログ パラメーターの 既定値を構成 することをお勧めします。 これにより冗長性が低下し、CLI コマンド構文が大幅に短縮されます。

アクティブなサブスクリプションを設定していない限り、 --subscription パラメーターはすべてのコマンドに必要です。 アクティブなサブスクリプションは、 コマンド az account set --subscription <subscription-name>を使用して設定できます。

コマンドを az sphere product create 使用します。

az sphere product create --resource-group MyResourceGroup --catalog MyCatalog  --name MyProduct --description "My new product"

コマンドを az sphere device-group create 使用してデバイス グループを作成し、それを製品に関連付けます。

az sphere device-group create --resource-group MyResourceGroup --catalog MyCatalog   --name "My Development Device Group" --product MyProduct -d "development device group for MyProduct"

展開ターゲット デバイス グループ。 デバイスがデプロイされたアプリケーションを受信するには、クラウド更新プログラムが有効になっているデバイス グループにデバイスを 割り当てる 必要があります。 既定では、各製品には、運用、フィールド テスト、開発、フィールド テスト OS 評価、運用 OS 評価の 5 つのデバイス グループがあります。 これらのデバイス グループのいずれかを使用することも、独自のデバイス グループ を作成することもできます。 デバイス グループがクラウド更新プログラムを受け入れるかどうかを確認するには、 az sphere device-group show を使用します。

デバイス グループ内のデバイスは、クラウド読み込み用に準備する必要があります。 これは、 appDevelopment 機能を持つ必要がないことを意味します。 ファクトリから直接出荷されるデバイスには、通常、 appDevelopment 機能がありません。 az sphere device enable-development コマンドを使用すると、この機能が追加されます。

appDevelopment 機能を削除するには、az sphere device enable-cloud-test を使用します。

CLI を使用する

コマンドを az sphere device enable-cloud-test 使用します。

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog

デバイス グループのデプロイを作成する

デプロイは、デバイス グループ内のすべてのデバイスに配布されるイメージのセットです。 デプロイには、アプリケーションとボード構成の両方を含めることができます。 各デプロイは、特定の製品内の特定のデバイス グループにリンクされます。 展開を作成するときは、製品名とデバイス グループ名 (次の例に示すように) またはデバイス グループ ID を含める必要があります。

ポータルを使用する

    • Azure Portal にサインインします。
    • Azure Sphere サービスを見つけるには、上部の検索バーで「 Azure Sphere」と入力して選択します。 [Azure Sphere] ページが表示されます。
  2. デプロイを作成するカタログを選択します。 サブスクリプション フィルターが適切に設定されていることを確認して、すべてのカタログとリソース グループを表示します。
  3. ページの左側にある [製品の管理>] を選択します。
  4. 次のページには、作成されたすべての製品が一覧表示されたテーブルが表示されます。 デプロイを作成する製品を選択します。
  5. 表は、選択した製品に関連付けられているすべてのデバイス グループを示しています。 デプロイを作成するデバイス グループを選択します。
  6. [ デプロイ ] タブを選択します。
  7. [デプロイ] タブの下にある [ + 作成 ] をクリックします。
  8. 表示されたビューで、既存のイメージを選択するか、[ + 追加 ] をクリックして新しいイメージをアップロードします。
  9. ビューの下部にある [ +作成] をクリックします。

CLI を使用する

続行する前に、「 デバイスを準備する」 の手順を完了し、次の手順を実行します。

  1. コマンドによって返される imageId を 書き留め、イメージ パッケージをアップロード します。

    az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path myImage.imagepackage

  2. コマンドを azsphere image-package show 使用して、イメージ パッケージの imageId を 取得します。

    azsphere image-package show --image-package myImage.imagepackage

    メモ

    image-package show は現在、Azure CLI 拡張機能ではサポートされていません。

    このコマンドは、 imageId を含むイメージ パッケージに関する情報を返します。

    Image package metadata:
  Section: Identity
   Image Type: Application
   Component ID: 1689d8b2-c835-2e27-27ad-e894d6d15fa9
   Image ID: be3f90bd-849f-487e-a170-7fe1ff03fe2d
  Section: Signature
   Signing Type: ECDsa256
   Cert: a8d5cc6958f48710140d7a26160fc1cfc31f5dfO
  Section: Debug 
   Image Name:       myImage
   Built On (UTC):   02/21/22 16:21:58
   Built On (Local): 02/21/22 16:21:58
  Section: Temporary Image

  3. デバイス グループの 新しいデプロイ を作成します。

    az sphere deployment create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --images <imageId returned from previous step>

イメージ ID のスペース区切りリストを --images 使用して、パラメーターに複数のイメージを指定できます。

カタログ内のデバイス グループを一覧表示するには、 az sphere device-group list を使用します。

カタログ内のすべてのイメージを一覧表示するには、 az sphere image list を使用します。

デプロイを更新する

デプロイを更新することはできません。 代わりに、新しいデプロイを作成する必要があります。 前のセクションの手順を繰り返し、必要に応じてパラメーターを更新します。