クイック スタート:初めての IoT Edge モジュールを仮想 Windows デバイスにデプロイするQuickstart: Deploy your first IoT Edge module to a virtual Windows device

このクイックスタートでは、コンテナー化されたコードを Windows IoT Edge 仮想デバイスに配置して、Azure IoT Edge を使ってみます。Try out Azure IoT Edge in this quickstart by deploying containerized code to a virtual Windows IoT Edge device. IoT Edge を使用すると、ご利用のデバイス上のコードをリモートで管理できるため、より多くのワークロードをエッジに送信できます。IoT Edge allows you to remotely manage code on your devices so that you can send more of your workloads to the edge. このクイックスタートでは、IoT Edge デバイスに Azure 仮想マシンを使用することをお勧めします。For this quickstart, we recommend using an Azure virtual machine for your IoT Edge device. 仮想マシンを使用することにより、テスト マシンをすばやく作成し、前提条件をインストールし、さらにテストが完了したら削除することができます。Using a virtual machine allows you to quickly create a test machine, install the prerequisites, and then delete it when you're finished.

このクイック スタートでは、次の方法について説明します。In this quickstart you learn how to:

  • IoT Hub を作成します。Create an IoT hub.
  • IoT Edge デバイスを IoT ハブに登録します。Register an IoT Edge device to your IoT hub.
  • IoT Edge ランタイムをご自分の仮想デバイスにインストールして開始します。Install and start the IoT Edge runtime on your virtual device.
  • モジュールを IoT Edge デバイスにリモートでデプロイし、テレメトリを IoT Hub に送信します。Remotely deploy a module to an IoT Edge device and send telemetry to IoT Hub.

図 - デバイスとクラウドのクイック スタートのアーキテクチャ

このクイックスタートでは、Windows 仮想マシンを作成し、IoT Edge デバイスとして構成する手順について説明します。This quickstart walks you through creating a Windows virtual machine and configuring it to be an IoT Edge device. その後、Azure portal からご自身のデバイスにモジュールを配置します。Then, you deploy a module from the Azure portal to your device. このクイックスタートで使用されているモジュールは、温度、湿度、圧力のデータを生成するシミュレートされたセンサーです。The module used in this quickstart is a simulated sensor that generates temperature, humidity, and pressure data. 他の Azure IoT Edge チュートリアルでは、ここで行う作業を基盤としており、ビジネスに関する分析情報を得るためにシミュレートされたデータを分析する追加のモジュールを配置しています。The other Azure IoT Edge tutorials build upon the work you do here by deploying additional modules that analyze the simulated data for business insights.

アクティブな Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。If you don't have an active Azure subscription, create a free account before you begin.

Azure Cloud Shell を使用するUse Azure Cloud Shell

Azure では、ブラウザーを介して使用できる対話型のシェル環境、Azure Cloud Shell がホストされています。Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. Cloud Shell で Bash または PowerShell を使用して、Azure サービスを操作できます。You can use either Bash or PowerShell with Cloud Shell to work with Azure services. ローカル環境に何もインストールしなくても、Cloud Shell にプレインストールされているコマンドを使用して、この記事のコードを実行できます。You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Azure Cloud Shell を開始するには:To start Azure Cloud Shell:

オプションOption 例とリンクExample/Link
コード ブロックの右上隅にある [使ってみる] を選択します。Select Try It in the upper-right corner of a code block. [使ってみる] を選択しても、コードは Cloud Shell に自動的にコピーされません。Selecting Try It doesn't automatically copy the code to Cloud Shell. Azure Cloud Shell の [使ってみる] の例
https://shell.azure.com に移動するか、 [Cloud Shell を起動する] ボタンを選択して、ブラウザーで Cloud Shell を開きます。Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. 新しいウィンドウで Cloud Shell を起動するLaunch Cloud Shell in a new window
Azure portal の右上にあるメニュー バーの [Cloud Shell] ボタンを選択します。Select the Cloud Shell button on the menu bar at the upper right in the Azure portal. Azure Portal の [Cloud Shell] ボタン

Azure Cloud Shell でこの記事のコードを実行するには:To run the code in this article in Azure Cloud Shell:

  1. Cloud Shell を開始します。Start Cloud Shell.

  2. [コピー] ボタンを選択して、コード ブロックをコードにコピーします。Select the Copy button on a code block to copy the code.

  3. Windows と Linux では Ctrl+Shift+V キーを選択し、macOS では Cmd+Shift+V キーを選択して、コードを Cloud Shell セッションに貼り付けます。Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Enter キーを選択して、コードを実行します。Select Enter to run the code.

このクイックスタートの多くの手順を実行するには、Azure CLI を使用します。You use the Azure CLI to complete many of the steps in this quickstart. Azure IoT には、追加機能を有効にするための拡張機能が用意されています。Azure IoT has an extension to enable additional functionality.

Azure IoT の拡張機能を Cloud Shell インスタンスに追加します。Add the Azure IoT extension to the Cloud Shell instance.

az extension add --name azure-iot

注意

この記事では、azure-iot と呼ばれる、Azure IoT 拡張機能の最新バージョンを使用します。This article uses the newest version of the Azure IoT extension, called azure-iot. 従来のバージョンは azure-cli-iot-ext と呼ばれます。一度にインストールできるバージョンは 1 つだけです。The legacy version is called azure-cli-iot-ext.You should only have one version installed at a time. コマンド az extension list を使用すると、現在インストールされている拡張機能を確認できます。You can use the command az extension list to validate the currently installed extensions.

拡張機能の従来のバージョンを削除するには、az extension remove --name azure-cli-iot-ext を使用します。Use az extension remove --name azure-cli-iot-ext to remove the legacy version of the extension.

拡張機能の新しいバージョンを追加するには、az extension add --name azure-iot を使用します。Use az extension add --name azure-iot to add the new version of the extension.

インストール済みの拡張機能を表示するには、az extension list を使用してください。To see what extensions you have installed, use az extension list.

前提条件Prerequisites

クラウド リソース:Cloud resources:

  • このクイック スタートで使用するすべてのリソースを管理するためのリソース グループです。A resource group to manage all the resources you use in this quickstart.

    az group create --name IoTEdgeResources --location westus2
    

IoT Edge デバイス:IoT Edge device:

  • IoT Edge デバイスとして機能する Windows 仮想マシン。A Windows virtual machine to act as your IoT Edge device. この仮想マシンを作成するには、次のコマンドを使用します。{password} は、セキュリティで保護されたパスワードに置き換えます。You can create this virtual machine using the following command, replacing {password} with a secure password:

    az vm create --resource-group IoTEdgeResources --name EdgeVM --image MicrosoftWindowsDesktop:Windows-10:rs5-pro:latest --admin-username azureuser --admin-password {password} --size Standard_DS1_v2
    

    新しい仮想マシンを作成して起動するまでに数分かかる場合があります。It may take a few minutes to create and start the new virtual machine.

    仮想マシンが起動したら、仮想マシンに接続するときに使用する RDP ファイルをダウンロードできます。Once your virtual machine starts, you can download an RDP file for use when connecting to your virtual machine:

    1. Azure portal で、新しい Windows 仮想マシンに移動します。Navigate to your new Windows virtual machine in the Azure portal.
    2. [接続] を選択します。Select Connect .
    3. [RDP] タブで、 [RDP ファイルのダウンロード] を選択します。On the RDP tab, select Download RDP File .

    リモート デスクトップ接続でこのファイルを開き、az vm create コマンドで指定した管理者名とパスワードを使用して Windows 仮想マシンに接続します。Open this file with Remote Desktop Connection to connect to your Windows virtual machine using the administrator name and password you specified with the az vm create command.

注意

Windows 仮想マシンは、Windows バージョン 1809 (ビルド 17763) を使用して起動されます。これは、最新の Windows の長期サポートのビルドです。Your Windows virtual machine starts with Windows version 1809 (build 17763), which is the latest Windows long-term support build. 既定では、Windows は 22 時間ごとに自動的に更新プログラムをチェックします。Windows automatically checks for updates every 22 hours by default. 仮想マシンのチェックが完了したら、Windows 用の IoT Edge と互換性のないバージョンの更新プログラムがプッシュされ、Windows 用の IoT Edge の機能をそれ以上使用できなくなります。After a check on your virtual machine, Windows pushes a version update that is incompatible with IoT Edge for Windows, which prevents further use of IoT Edge for Windows features. 仮想マシンの使用を 22 時間以内に制限するか、Windows の更新プログラムを一時的に停止することをお勧めします。We recommend limiting use of your virtual machine to within 22 hours or temporarily pausing Windows updates.

このクイックスタートでは、わかりやすくするための Windows デスクトップの仮想マシンを使用します。This quickstart uses a Windows desktop virtual machine for simplicity. 運用シナリオ向けに一般提供されている Windows オペレーティング システムについては、「Azure IoT Edge のサポートされるシステム」を参照してください。For information about which Windows operating systems are generally available for production scenarios, see Azure IoT Edge supported systems.

IoT Core を実行しているデバイスなど、IoT Edge 用に独自の Windows デバイスを構成したい場合は、Azure IoT Edge ランタイムをインストールする方法に関するページの手順に従ってください。If you want to configure your own Windows device for IoT Edge, including devices running IoT Core, follow the steps in Install the Azure IoT Edge runtime.

IoT Hub の作成Create an IoT hub

このクイック スタートでは、最初に Azure CLI を使用して IoT ハブを作成します。Start the quickstart by creating an IoT hub with Azure CLI.

図 - クラウドで IoT ハブを作成する

このクイック スタートでは無料レベルの IoT Hub を使用できます。The free level of IoT Hub works for this quickstart. IoT Hub を以前に使用したことがあり、ハブを作成済みである場合は、その IoT ハブを使用することができます。If you've used IoT Hub in the past and already have a hub created, you can use that IoT hub.

次のコードにより、無料の F1 ハブがリソース グループ IoTEdgeResources に作成されます。The following code creates a free F1 hub in the resource group IoTEdgeResources. {hub_name} は、実際の IoT ハブの一意の名前に置き換えてください。Replace {hub_name} with a unique name for your IoT hub. IoT ハブの作成には数分かかることがあります。It might take a few minutes to create an IoT Hub.

az iot hub create --resource-group IoTEdgeResources --name {hub_name} --sku F1 --partition-count 2

サブスクリプションに無料のハブが既に 1 つあるためにエラーが発生する場合は、SKU を S1 に変更します。If you get an error because there's already one free hub in your subscription, change the SKU to S1 . IoT ハブの名前が利用できないというエラーが発生した場合、自分以外のだれかが既にその名前のハブを所有していることを意味します。If you get an error that the IoT Hub name isn't available, it means that someone else already has a hub with that name. 新しい名前を試してください。Try a new name.

IoT Edge デバイスを登録するRegister an IoT Edge device

新しく作成された IoT ハブに IoT Edge デバイスを登録します。Register an IoT Edge device with your newly created IoT hub. 図 - IoT ハブ ID でデバイスを登録するDiagram - Register a device with an IoT Hub identity

お使いの IoT ハブと通信できるようにシミュレートされたデバイスのデバイス ID を作成します。Create a device identity for your simulated device so that it can communicate with your IoT hub. デバイス ID はクラウドに置かれるので、デバイスの一意の接続文字列を使用して、物理デバイスとデバイス ID とを関連付けることになります。The device identity lives in the cloud, and you use a unique device connection string to associate a physical device to a device identity.

IoT Edge デバイスは、一般的な IoT デバイスとは異なる動作をし、別に管理できるため、この ID は IoT Edge デバイス用として --edge-enabled フラグで宣言します。Since IoT Edge devices behave and can be managed differently than typical IoT devices, declare this identity to be for an IoT Edge device with the --edge-enabled flag.

  1. Azure Cloud Shell で、次のコマンドを入力して、 myEdgeDevice という名前のデバイスをハブに作成します。In the Azure Cloud Shell, enter the following command to create a device named myEdgeDevice in your hub.

    az iot hub device-identity create --device-id myEdgeDevice --edge-enabled --hub-name {hub_name}
    

    iothubowner ポリシー キーに関するエラーが表示された場合は、Cloud Shell で最新バージョンの azure-iot 拡張機能が実行されていることを確認してください。If you get an error about iothubowner policy keys, make sure that your Cloud Shell is running the latest version of the azure-iot extension.

  2. デバイスの接続文字列を確認します。この接続文字列により、IoT Hub 内で物理デバイスとその ID をリンクさせます。View the connection string for your device, which links your physical device with its identity in IoT Hub. これには、IoT ハブの名前、デバイスの名前、2 つの間の接続を認証する共有キーが含まれています。It contains the name of your IoT hub, the name of your device, and then a shared key that authenticates connections between the two.

    az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name {hub_name}
    
  3. JSON 出力から connectionString キーの値をコピーして保存します。Copy the value of the connectionString key from the JSON output and save it. この値はデバイスの接続文字列です。This value is the device connection string. 次のセクションでは、この接続文字列を使用して IoT Edge ランタイムを構成します。You'll use this connection string to configure the IoT Edge runtime in the next section.

    CLI の出力から接続文字列を取得する

IoT Edge ランタイムをインストールして開始するInstall and start the IoT Edge runtime

Azure IoT Edge ランタイムを IoT Edge デバイスにインストールし、デバイスの接続文字列を使用してその構成を行います。Install the Azure IoT Edge runtime on your IoT Edge device and configure it with a device connection string. 図 - デバイスでランタイムを開始するDiagram - Start the runtime on device

IoT Edge ランタイムはすべての IoT Edge デバイスに展開されます。The IoT Edge runtime is deployed on all IoT Edge devices. これは 3 つのコンポーネントで構成されます。It has three components. IoT Edge セキュリティ デーモン は、IoT Edge デバイスが起動するたびに開始され、IoT Edge エージェントを起動してデバイスをブートストラップします。The IoT Edge security daemon starts each time an IoT Edge device boots and bootstraps the device by starting the IoT Edge agent. IoT Edge エージェント は、IoT Edge ハブなど、IoT Edge デバイス上のモジュールのデプロイと監視を管理します。The IoT Edge agent manages deployment and monitoring of modules on the IoT Edge device, including the IoT Edge hub. IoT Edge ハブ は、IoT Edge デバイス上のモジュール間、およびデバイスと IoT ハブの間の通信を処理します。The IoT Edge hub handles communications between modules on the IoT Edge device, and between the device and IoT Hub.

インストール スクリプトには、IoT Edge デバイス上のコンテナー イメージを管理する Moby というコンテナー エンジンも含まれています。The installation script also includes a container engine called Moby that manages the container images on your IoT Edge device.

ランタイムのインストール中に、デバイスの接続文字列を求められます。During the runtime installation, you're asked for a device connection string. Azure CLI から取得した文字列を使用してください。Use the string that you retrieved from the Azure CLI. この文字列によって、Azure 内の IoT Edge デバイス ID と物理デバイスとが関連付けられます。This string associates your physical device with the IoT Edge device identity in Azure.

IoT Edge デバイスに接続するConnect to your IoT Edge device

このセクションの手順はすべて IoT Edge デバイス上で実行されるため、ここでリモート デスクトップ経由でその仮想マシンに接続します。The steps in this section all take place on your IoT Edge device, so you want to connect to that virtual machine now via remote desktop.

IoT Edge サービスをインストールして構成するInstall and configure the IoT Edge service

PowerShell を使用して IoT Edge ランタイムをダウンロードし、インストールします。Use PowerShell to download and install the IoT Edge runtime. IoT Hub から取得したデバイスの接続文字列を使用して、目的のデバイスを構成します。Use the device connection string that you retrieved from IoT Hub to configure your device.

  1. 仮想マシン内で、管理者として PowerShell を実行します。In the virtual machine, run PowerShell as an administrator.

    注意

    IoT Edge をインストールするには、PowerShell (x86) ではなく PowerShell の AMD64 セッションを使用します。Use an AMD64 session of PowerShell to install IoT Edge, not PowerShell (x86). どのセッションの種類を使用しているかがわからない場合は、次のコマンドを実行します。If you're not sure which session type you're using, run the following command:

    (Get-Process -Id $PID).StartInfo.EnvironmentVariables["PROCESSOR_ARCHITECTURE"]
    
  2. Deploy-IoTEdge コマンドを実行すると、ご使用の Windows マシンがサポートされているバージョンであることが確認され、コンテナーの機能が有効化され、Moby ランタイムがダウンロードされた後、IoT Edge ランタイムがダウンロードされます。The Deploy-IoTEdge command checks that your Windows machine is on a supported version, turns on the containers feature, downloads the Moby runtime, and then downloads the IoT Edge runtime.

    . {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; `
    Deploy-IoTEdge -ContainerOs Windows
    
  3. 場合によってはマシンが自動的に再起動します。Your machine may restart automatically. Deploy-IoTEdge コマンドから再起動を促すメッセージが表示された場合は、再起動します。If you are prompted by the Deploy-IoTEdge command to reboot, do so now.

  4. 再び PowerShell を管理者として実行します。Run PowerShell as an administrator again.

  5. Initialize-IoTEdge コマンドを使用して、お使いのマシンに IoT Edge ランタイムを構成します。The Initialize-IoTEdge command configures the IoT Edge runtime on your machine. このコマンドでは、Windows コンテナーを使用した手動プロビジョニングが既定で設定されます。The command defaults to manual provisioning with Windows containers.

    . {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; `
    Initialize-IoTEdge -ContainerOs Windows
    
  6. DeviceConnectionString を求められたら、前のセクションでコピーした文字列を入力します。When prompted for a DeviceConnectionString , provide the string that you copied in the previous section. 接続文字列の前後に引用符は含めないでください。Don't include quotes around the connection string.

IoT Edge ランタイムの状態を確認するView the IoT Edge runtime status

ランタイムが正常にインストールされ、構成されていることを確認します。Verify that the runtime was successfully installed and configured. インストールが完了し、IoT Edge エージェント モジュールが起動するまでに数分かかる場合があります。It may take a few minutes for the installation to complete and the IoT Edge agent module to start.

  1. IoT Edge サービスの状態を確認します。Check the status of the IoT Edge service.

    Get-Service iotedge
    
  2. サービスのトラブルシューティングが必要な場合は、サービス ログを取得します。If you need to troubleshoot the service, retrieve the service logs.

    . {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; Get-IoTEdgeLog
    
  3. IoT Edge デバイス上で実行されているすべてのモジュールを表示します。View all the modules running on your IoT Edge device. 初めてサービスが開始されたので、 edgeAgent モジュールが実行されていることのみが確認できます。Since the service just started for the first time, you should only see the edgeAgent module running. edgeAgent モジュールが既定で実行され、デバイスにデプロイする追加モジュールのインストールと起動を支援します。The edgeAgent module runs by default and helps to install and start any additional modules that you deploy to your device.

    iotedge list
    

    ご自身のデバイス上の 1 つのモジュールを表示する

IoT Edge デバイスの構成はこれで完了です。Your IoT Edge device is now configured. クラウドからモジュールをデプロイして実行することができます。It's ready to run cloud-deployed modules.

モジュールを展開するDeploy a module

Azure IoT Edge デバイスをクラウドから管理し、IoT Hub に利用統計情報を送信するモジュールをデプロイします。Manage your Azure IoT Edge device from the cloud to deploy a module that sends telemetry data to IoT Hub.

図 - クラウドからデバイスにモジュールを配置する

Azure IoT Edge の主要な機能の 1 つは、クラウドからお客様の IoT Edge デバイスにコードをデプロイできることです。One of the key capabilities of Azure IoT Edge is being able to deploy code to your IoT Edge devices from the cloud. IoT Edge モジュールは、コンテナーとして実装されている実行可能ファイルのパッケージです。IoT Edge modules are executable packages implemented as containers. このセクションでは、Azure Marketplace の IoT Edge モジュールのセクションで事前に構築したモジュールを、Azure IoT ハブから直接デプロイします。In this section, you deploy a pre-built module from the IoT Edge Modules section of the Azure Marketplace directly from your Azure IoT Hub.

このセクションでデプロイするモジュールはセンサーをシミュレートし、生成されたデータを送信します。The module that you deploy in this section simulates a sensor and sends generated data. シミュレートされたデータを開発とテストに使用できるため、このモジュールは IoT Edge の使用を開始する際にコードの一部として役に立ちます。This module is a useful piece of code when you're getting started with IoT Edge because you can use the simulated data for development and testing. このモジュールで行われる内容を正確に確認したい場合は、シミュレートされた温度センサーのソース コードをご覧いただけます。If you want to see exactly what this module does, you can view the simulated temperature sensor source code.

Azure Marketplace からお客様の最初のモジュールをデプロイするには、次の手順を使用します。To deploy your first module from the Azure Marketplace, use the following steps:

  1. Azure Portal にサインインし、IoT Hub に移動します。Sign in to the Azure portal and navigate to your IoT hub.

  2. 左側のペインのメニューで、 [デバイスの自動管理] の下にある [IoT Edge] を選択します。From the menu on the left pane, under Automatic Device Management, select IoT Edge.

  3. デバイスの一覧でターゲット デバイスのデバイス ID をクリックします。Click on the device ID of the target device from the list of devices.

  4. 上部のバーで [モジュールの設定] を選択します。On the upper bar, select Set Modules.

    [デバイスの詳細] ページから [モジュールの設定] を選択する

  5. このページの [IoT Edge モジュール] セクションで、 [追加] をクリックし、ドロップダウンメニューから [Marketplace モジュール] を選択します。In the IoT Edge Modules section of the page, click Add and select Marketplace Module from the drop-down menu.

    Marketplace モジュールを追加する

  6. [IoT Edge モジュールの Marketplace] で、"シミュレートされた温度センサー" を検索し、そのモジュールを選択します。In the IoT Edge Module Marketplace, search for "Simulated Temperature Sensor" and select that module.

  7. SimulatedTemperatureSensor モジュールが [IoT Edge モジュール] セクションに追加されており、[必要な状態] が [実行しています] になっていることにご注目ください。Notice that the SimulatedTemperatureSensor module is added to the IoT Edge Modules section, with the desired status running.

    次へ:ルート を選択し、ウィザードの次の手順に進みます。Select Next: Routes to continue to the next step of the wizard.

    温度センサー モジュールが表示されたら、次の手順に進みます。

  8. ウィザードの [ルート] タブで、モジュールと IoT ハブの間でメッセージが渡される方法を定義できます。On the Routes tab of the wizard, you can define how messages are passed between modules and the IoT Hub. ルートは名前と値のペアを使用して作成されます。Routes are constructed using name/value pairs. このページには 2 つのルートが表示されるはずです。You should see two routes on this page. route という名前の既定のルートから IoT Hub (名前は $upstream) にすべてのメッセージが送信されます。The default route called route sends all messages to IoT Hub (which is called $upstream). Marketplace からモジュールを追加したとき、SimulatedTemperatureSensorToIoTHub という名前の 2 つ目のルートが自動的に作成されました。A second route called SimulatedTemperatureSensorToIoTHub was created automatically when you added the module from the Marketplace. このルートによって、特に、シミュレートされた温度モジュールから IoT Hub にすべてのメッセージが送信されます。This route sends all messages specifically from the simulated temperature module to IoT Hub. この場合、既定のルートは冗長となるため、削除できます。You can delete the default route because it's redundant in this case.

    次へ:確認と作成 を選択し、ウィザードの次の手順に進みます。Select Next: Review + create to continue to the next step of the wizard.

    既定のルートを削除し、次の手順に進みます。

  9. ウィザードの [確認と作成] タブでは、IoT Edge デバイスにデプロイされているすべてのモジュールを定義する JSON ファイルをプレビューできます。On the Review + create tab of the wizard, you can preview the JSON file that defines all the modules that get deployed to your IoT Edge device. SimulatedTemperatureSensor モジュールに加え、edgeAgentedgeHub という 2 つのランタイム モジュールが含まれていることに注目してください。Notice that the SimulatedTemperatureSensor module is included as well as the two runtime modules, edgeAgent and edgeHub. 確認が完了したら [作成] を選択します。Select Create when you're done reviewing.

    IoT Edge デバイスに新しいデプロイを送信しても、デバイスには何もプッシュされません。When you submit a new deployment to an IoT Edge device, nothing is pushed to your device. 代わりに、デバイスから IoT Hub に対して、新しい指示のクエリが定期的に実行されます。Instead, the device queries IoT Hub regularly for any new instructions. 更新されたデプロイ マニフェストがデバイスによって検出されると、新しいデプロイに関する情報が使用されてクラウドからモジュール イメージがプルされ、ローカルでのモジュールの実行が開始されます。If the device finds an updated deployment manifest, it uses the information about the new deployment to pull the module images from the cloud then starts running the modules locally. このプロセスは数分かかることがあります。This process may take a few minutes.

  10. モジュールのデプロイの詳細が作成されると、ウィザードは [デバイスの詳細] ページに戻ります。After you create the module deployment details, the wizard returns you to the device details page. [デバイスの詳細] ページの [モジュール] タブでデプロイの状態を確認します。$edgeAgent、$edgeHub、SimulatedTemperatureSensor という 3 つのモジュールが表示されているはずです。On the device details page, view the deployment status in the Modules tab. Three modules should be listed: $edgeAgent, $edgeHub, and SimulatedTemperatureSensor. デプロイで指定されたとおりに表示されているのにデバイスによってレポートされていないモジュールが 1 つ以上ある場合、それらはまだお客様の IoT Edge デバイスによって起動中です。If one or more of the modules are listed as specified in deployment but not reported by device, your IoT Edge device is still starting them. 少し待ってから、ページの上部にある [更新] をクリックします。Wait a few moments and select Refresh at the top of the page.

    デプロイ済みのモジュールの一覧に SimulatedTemperatureSensor を表示する

生成されたデータを表示するView generated data

このクイック スタートでは、新しい IoT Edge デバイスを作成し、そこに IoT Edge ランタイムをインストールしました。In this quickstart, you created a new IoT Edge device and installed the IoT Edge runtime on it. その後、Azure portal を使用して、IoT Edge モジュールをデプロイし、デバイス自体を変更せずにモジュールをデバイスで実行しました。Then, you used the Azure portal to deploy an IoT Edge module to run on the device without having to make changes to the device itself.

この場合、プッシュしたモジュールによって、後でテストするために使用できるサンプル環境データが生成されます。In this case, the module that you pushed generates sample environment data that you can use for testing later. シミュレートされたセンサーは、マシンと、マシンの周囲の環境の両方を監視します。The simulated sensor is monitoring both a machine and the environment around the machine. たとえば、このセンサーは、サーバー ルーム、工場のフロア、または風力タービンに配置されている可能性があります。For example, this sensor might be in a server room, on a factory floor, or on a wind turbine. メッセージには、周囲の温度と湿度、機械の温度と圧力、タイムスタンプが含まれます。The message includes ambient temperature and humidity, machine temperature and pressure, and a timestamp. IoT Edge のチュートリアルでは、このモジュールによって作成されたデータを分析用のテスト データとして使用します。The IoT Edge tutorials use the data created by this module as test data for analytics.

IoT Edge デバイスで、クラウドからデプロイされたモジュールが実行されていることを確認します。Confirm that the module deployed from the cloud is running on your IoT Edge device.

iotedge list

ご利用のデバイスの 3 つのモジュールを表示する

温度センサー モジュールからクラウドに送信されているメッセージを確認します。View the messages being sent from the temperature sensor module to the cloud.

iotedge logs SimulatedTemperatureSensor -f

ヒント

IoT Edge のコマンドでは、モジュール名を参照する際に大文字と小文字が区別されます。IoT Edge commands are case-sensitive when referring to module names.

モジュールからのデータを表示する

Visual Studio Code 用の Azure IoT Hub の拡張機能を使用して、IoT ハブに到着したメッセージを監視することもできます。You can also watch the messages arrive at your IoT hub by using the Azure IoT Hub extension for Visual Studio Code.

リソースをクリーンアップするClean up resources

IoT Edge のチュートリアルに進む場合は、このクイック スタートで登録および設定したデバイスを使用できます。If you want to continue on to the IoT Edge tutorials, you can use the device that you registered and set up in this quickstart. それ以外の場合は、課金されないようにするために、作成した Azure リソースを削除してもかまいません。Otherwise, you can delete the Azure resources that you created to avoid charges.

新しいリソース グループで仮想マシンと IoT ハブを作成した場合、そのグループと関連するすべてのリソースを削除できます。If you created your virtual machine and IoT hub in a new resource group, you can delete that group and all the associated resources. リソース グループの内容を再確認して、残しておくべきものがないことを確認してください。Double check the contents of the resource group to make sure that there's nothing you want to keep. グループ全体を削除したくない場合は、リソースを個別に削除してもかまいません。If you don't want to delete the whole group, you can delete individual resources instead.

重要

リソース グループを削除すると、元に戻すことができません。Deleting a resource group is irreversible.

IoTEdgeResources グループを削除します。Remove the IoTEdgeResources group. リソース グループを削除するのに数分かかる場合があります。It might take a few minutes to delete a resource group.

az group delete --name IoTEdgeResources

リソース グループが削除されたことは、リソース グループの一覧を表示することによって確認できます。You can confirm the resource group is removed by viewing the list of resource groups.

az group list

次のステップNext steps

このクイック スタートでは、IoT Edge デバイスを作成し、Azure IoT Edge クラウド インターフェイスを使用してコードをデバイスにデプロイしました。In this quickstart, you created an IoT Edge device and used the Azure IoT Edge cloud interface to deploy code onto the device. その環境に関する生データを生成するテスト デバイスができあがりました。Now, you have a test device generating raw data about its environment.

次の手順では、ビジネス ロジックを実行する IoT Edge モジュールの作成を開始できるように、ローカル開発環境を設定します。The next step is to set up your local development environment so that you can start creating IoT Edge modules that run your business logic.