チュートリアル: クラウド デプロイを作成する
重要
これは Azure Sphere (レガシ) のドキュメントです。 Azure Sphere (レガシ) は 2027 年 9 月 27 日に 再提供されておりユーザーは現時点で Azure Sphere (統合) に移行する必要があります。 TOC の上にある Version セレクターを使用して、Azure Sphere (統合) のドキュメントを表示します。
このクイック スタートでは、最初のクラウド ベースのアプリケーション デプロイを作成する方法を示します。 クラウド ベースのデプロイでは、ターゲット製品内のデバイス グループに割り当てられているデプロイを通してアプリケーションが配信されます。
このチュートリアルでは、次の作業を行う方法について説明します。
- 製品の作成
- デバイスのクラウドベースのデプロイを有効にする
- 配置を作成する
- トリガーのデプロイ
- 開発とデバッグを再度有効にする
前提条件
- Azure Sphere デバイスは、コンピューターとインターネットに接続されています。
- Tutorial: 高度なアプリケーションのビルドアプリケーションのイメージ パッケージ ファイルが完成しました。
製品の作成
productは、特定の機能を実行し、特定のアプリケーションを実行する Azure Sphere デバイスのモデルを識別します。
まだ製品を持っていない場合は、azsphere product create コマンドを使用して 1 つ作成します。
azsphere product create --name MyProduct --description "My First Product"
製品名は Azure Sphere テナント内で一意である必要があり、大文字と小文字は区別されません。 名前にスペースが含まれている場合は、例のようにコマンドで二重引用符で囲みます。
azsphere product create コマンドは、新しい製品の既定の device グループ開発、フィールド テスト、運用、フィールド テスト OS 評価、運用 OS 評価の 5 つの既定のグループを自動的に作成します。 デバイス グループは、デバイスの使用方法に応じてデバイスを整理する方法を提供します。
デバイスのクラウドベースのデプロイを有効にする
クラウド ベースのデプロイ プロセスをテストする前に、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 を提供し、すべての製品のデバイス グループを一意に識別します。 または、製品名とデバイス グループ名のペアを <product-name>/<device-group-name> 形式で使用することもできます。 この名前のペアによって、特定の製品のデバイス グループが一意に識別されます。
フィールド テスト デバイス グループと、 製品の作成で作成した製品の名前を指定します。
<image-ID> を、「Tutorial: 高度なアプリケーションのビルド」で作成したイメージ パッケージのイメージ 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 デプロイの基本について学習する
トラブルシューティング
上記の操作で問題が発生した場合は、 トラブルシューティングのガイダンスを参照してください。