チュートリアル: クラウドデプロイを作成する
このクイック スタートでは、初めてのクラウドベースのアプリケーションデプロイを作成する方法を示します。 クラウドベースのデプロイは、ターゲット製品内のデバイス グループに割り当てられたデプロイを通じてアプリケーションを提供します。
このチュートリアルでは、次の方法について説明します。
- 製品を作成する
- デバイスのクラウドベースのデプロイを有効にする
- デプロイを作成する
- デプロイをトリガーする
- 開発とデバッグを再度有効にする
前提 条件
- Azure Sphere デバイスは、コンピューターとインターネットに接続されています。
- 「チュートリアル: 高度なアプリケーションをビルドし、アプリケーションのイメージ パッケージ ファイルを作成する」を完了しました。
製品を作成する
製品は、特定の関数を実行し、特定のアプリケーションを実行する Azure Sphere デバイスのモデルを識別します。
製品がまだない場合は、 azsphere product create コマンドを使用して製品を作成します。
azsphere product create --name MyProduct --description "My First Product"
製品名は Azure Sphere テナント内で一意である必要があり、大文字と小文字は区別されません。 名前にスペースが含まれている場合は、例のように、コマンドで二重引用符で囲みます。
azsphere product create コマンドは、新しい製品の 5 つの既定のデバイス グループ (開発、フィールド テスト、運用、フィールド テスト OS 評価、運用 OS 評価) を自動的に作成します。 デバイス グループは、デバイスの使用方法に応じてデバイスを整理する方法を提供します。
デバイスのクラウドベースのデプロイを有効にする
クラウドベースのデプロイ プロセスをテストする前に、Azure Sphere デバイスがクラウドベースのアプリケーション更新プログラムを受け入れる準備ができている必要があります。 azsphere device enable-cloud-test コマンドを使用して、デバイスを準備します。
azsphere device enable-cloud-test --product MyProduct
このコマンド:
- 前の手順で作成した MyProduct モデルとしてデバイスを識別します。
- デバイスをフィールド テスト デバイス グループに割り当てます。これにより、クラウドベースのアプリケーションの更新が可能になります。
- SDK がアプリケーションをデバイスに読み込む機能を無効にして、クラウドベースのアプリケーションのみを読み込むことができます。
Azure Sphere Security Service では、デバイス グループと製品を使用して、デバイス上 のアプリケーションを更新 するかどうかを判断します。
デプロイを作成する
デプロイは、Azure Sphere クラウド サービスから特定のデバイス グループ内のデバイスにデプロイできる一連のイメージです。
デプロイを作成するには:
- azsphere image add を使用して、イメージ パッケージを Azure Sphere テナントにアップロードします。
- azsphere device-group deployment create を使用して、アップロードされたイメージの デバイス グループの新しいデプロイを作成します。
- イメージ パッケージをアップロードします。
azsphere image add --image <path-to-image>
出力には、次のようなものが表示されます。
Uploading image from file 'Blink.imagepackage':
--> Image ID: <image-ID>
--> Component ID: <component-ID>
--> Component name: 'Blink'
Removing temporary state for uploaded image.
Successfully uploaded image with ID '<image-id>' and name 'Blink' to component with ID '<component-id>'.
次の手順では、イメージ ID を使用します。
- デバイス グループの新しいデプロイを作成します。
azsphere device-group deployment create --device-group <device-group-ID> --images <image-ID>
または
azsphere device-group deployment create --device-group '<product-name>/<device-group-name>' --images <image-ID>
製品 MyProduct とデバイス グループのフィールド テストでは、次の 2 番目のフォームを使用してデプロイを簡単に作成できます。
azsphere device-group deployment create --device-group "MyProduct/Field Test" --images <image-ID>
複数の値を --images
指定するには、スペースで区切られた値の一覧を入力します。
パラメーターは --device-group
、デバイス グループを識別します。 デバイス グループ ID は GUID を提供します。この GUID は、すべての製品にわたってデバイス グループを一意に識別します。 または、製品名とデバイス グループ名のペアを<製品名/<device-group-name>> 形式で使用することもできます。 この名前のペアは、特定の製品のデバイス グループを一意に識別します。
[フィールド テスト デバイス] グループと、[製品の作成] で作成した製品の名前 を指定します。
image-ID は>、「チュートリアル: 高度なアプリケーションを構築する」で作成したイメージ パッケージのイメージ ID に置き換えます。< Azure Sphere CLI については、イメージ ID の取得に関する情報については、「 azsphere device-group deployment create 」を参照してください。
デプロイが設定されていることを確認するには、 azsphere device image list-targeted コマンドを使用します。
デプロイをトリガーする
前の手順では、必要なすべてのデプロイ要素を設定しました。 ダウンロードをすぐにトリガーするには、Azure Sphere デバイスの [リセット ] ボタンを押します。 アプリケーションは数分以内にダウンロードして起動し、LED が点滅し始めることがわかります。
アプリケーションがデバイスにインストールされたことを確認するには、 azsphere device image list-installed コマンドを使用します。 デプロイの結果がすぐには表示されない場合があります。 コマンドの実行時にデプロイが一覧表示されない場合は、数分後にもう一度やり直してください。 デプロイが完了するとすぐに、Azure Sphere デバイスで LED が点滅し始めます。
次の手順
アプリケーションの開発とテストを続けるにつれて、より広範にデプロイする準備ができるまで、アプリケーションをサイドロードする必要があります。 azsphere device enable-cloud-test コマンドを元に戻し、開発とデバッグのためにデバイスを有効にするには、azsphere device enable-development を使用します。
次の記事に進み、次の方法を学習します。
リアルタイム アプリケーションをビルドする準備ができていない場合は、次の操作を行うこともできます。
- GitHub の Azure Sphere サンプル を調べる
- Azure Sphere デプロイの基本の詳細
トラブルシューティング
上記の操作で問題が発生した場合は、 トラブルシューティングのガイダンスを参照してください。