クラウド デプロイを作成する
クラウドからアプリケーションをデプロイするには、アプリケーション イメージを Azure Sphere カタログにアップロードし、Azure Sphere デバイスにイメージを配布するデプロイを作成します。 デプロイを作成するには、Azure Sphere にサインインしている必要があります。また、管理者の役割を持っている必要があります。 さらに、クラウド デプロイを受信するようにデバイスが準備されている必要があります。
有効にするには、デプロイが次の規則に従う必要があります。
- デプロイの合計サイズは 1 MiB 未満にする必要があります。
- デプロイには、複数のボード構成ファイルを含めることができます。
デバイスを準備する
デバイスは、クラウドからアプリケーションを受信する前に、製品を持ち、デバイス グループに属している必要があり、 AppDevelopment 機能 インストールできません。
デバイスの製品をまだ作成していない場合は、デプロイを作成する前に作成する必要があります。 製品を作成するには:
ポータルの使用
- Azure portal にサインインします。 Azure Sphere サービスを見つけるには、上部の検索バーに「Azure Sphere入力して選択します。 Azure Sphere ページが表示されます。
- デプロイを作成するカタログを選択します。 すべてのカタログとリソース グループを表示するには、サブスクリプション フィルターが適切に設定されていることを確認します。
- カタログ ページの左側から Manage>Products を選択します。
- カタログ ページの上部にある [ + 作成 をクリックします。
- 製品の名前と説明を入力します。 既定のデバイス グループを作成するかどうかを示すチェック ボックスをオンにします。 マークされている場合は、開発、フィールド テスト、フィールド テスト OS 評価、運用、運用 OS 評価の既定のデバイス グループが作成されます。
- 最後に、ページの下部にある Create をクリックします。
既定のデバイス グループを作成しないことを選択した場合は、デバイス グループを手動で作成し、製品に関連付ける必要があります。
- ページの左側から Manage>Device Groups を選択します。
- ページの上部にある [ + 作成 をクリックします。
- 上記の手順で作成した製品を選択します。
- デバイス グループの名前と簡単な説明を入力します。
- デバイス グループのオペレーティング システム (OS) フィードを選択します。 RetailEval フィードは、Retail フィードより前のプレリリース OS バージョンを受け取ります。 したがって、 RetailEval は運用環境のデバイスには推奨されません。 実稼働デバイスの Retail フィードを選択します。
- デバイス グループの更新ポリシーを選択します。 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 つのデバイス グループがあります。 これらのデバイス グループの 1 つを使用することも、独自に作成することもできます。 デバイス グループがクラウド更新プログラムを受け入れるかどうかを確認するには、 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 ページが表示されます。
- デプロイを作成するカタログを選択します。 すべてのカタログとリソース グループを表示するには、サブスクリプション フィルターが適切に設定されていることを確認します。
- ページの左側にある Manage>Products を選択します。
- 次のページには、作成されたすべての製品が一覧表示されたテーブルが表示されます。 デプロイを作成する製品を選択します。
- テーブルには、選択した製品に関連付けられているすべてのデバイス グループが表示されます。 デプロイを作成するデバイス グループを選択します。
- Deployments タブを選択します。
- [デプロイ] タブの下にある [ + 作成 をクリックします。
- 表示されたビューで、既存のイメージを選択するか、 + 追加 をクリックして新しいイメージをアップロードします。
- ビューの下部にある [ + 作成をクリックします。
CLI の使用
次に進む前に、 Prepare デバイス の手順を完了します。
command によって返されるimageIdを書き留め、イメージ パッケージをアップロードします:
az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path myImage.imagepackage
azsphere image-package show
コマンドを使用して、イメージ パッケージの imageId を取得します。azsphere image-package show --image-package myImage.imagepackage
Note
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
デバイス グループの 新しい展開 を作成します。
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 イメージ リストを使用します。
配置の更新
デプロイを更新することはできません。 代わりに、新しいデプロイを作成する必要があります。 前のセクションの手順を繰り返し、必要に応じてパラメーターを更新します。