Skip to content

Latest commit

 

History

History
72 lines (50 loc) · 4.27 KB

how-to-deploy-modules-portal.md

File metadata and controls

72 lines (50 loc) · 4.27 KB
title description author manager ms.author ms.date ms.topic ms.reviewer ms.service services
Deploy Azure IoT Edge modules (portal) | Microsoft Docs
Use the Azure portal to deploy modules to an IoT Edge device
kgremban
philmea
kgremban
06/06/2018
conceptual
menchi
iot-edge
iot-edge

Deploy Azure IoT Edge modules from the Azure portal

Once you create IoT Edge modules with your business logic, you want to deploy them to your devices to operate at the edge. If you have multiple modules that work together to collect and process data, you can deploy them all at once and declare the routing rules that connect them.

This article shows how the Azure portal guides you through creating a deployment manifest and pushing the deployment to an IoT Edge device. For information about creating a deployment that targets multiple devices based on their shared tags, see Deploy and monitor IoT Edge modules at scale

Prerequisites

Select your device

  1. Sign in to the Azure portal and navigate to your IoT hub.
  2. Select IoT Edge from the menu.
  3. Click on the ID of the target device from the list of devices.
  4. Select Set Modules.

Configure a deployment manifest

A deployment manifest is a JSON document that describes which modules to deploy, how data flows between the modules, and desired properties of the module twins. For more information about how deployment manifests work and how to create them, see Understand how IoT Edge modules can be used, configured, and reused.

The Azure portal has a wizard that walks you through creating the deployment manifest, instead of building the JSON document manually. It has three steps: Add modules, Specify routes, and Review deployment.

Add modules

  1. In the Registry settings section of the page, provide the credentials to access any private container registries that contain your module images.
  2. In the Deployment modules section of the page, select Add.
  3. Look at the types of modules from the drop-down list:
    • IoT Edge Module - the default option.
    • Azure Stream Analytics Module - only modules generated from an Azure Stream Analytics workload.
  4. Select the IoT Edge Module.
  5. Provide a name for the module, then specify the container image. For example:
    • Name - tempSensor
    • Image URI - mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.0
  6. Fill out the optional fields if necessary. For more information about container create options, restart policy, and desired status see EdgeAgent desired properties. For more information about the module twin see Define or update desired properties.
  7. Select Save.
  8. Repeat steps 2-6 to add additional modules to your deployment.
  9. Select Next to continue to the routes section.

Specify routes

By default the wizard gives you a route called route and defined as FROM / INTO $upstream*, which means that any messages output by any modules are sent to your IoT hub.

Add or update the routes with information from Declare routes, then select Next to continue to the review section.

Review deployment

The review section shows you the JSON deployment manifest that was created based on your selections in the previous two sections. Note that there are two modules declared that you didn't add: $edgeAgent and $edgeHub. These two modules make up the IoT Edge runtime and are required defaults in every deployment.

Review your deployment information, then select Submit.

View modules on your device

Once you've deployed modules to your device, you can view all of them in the Device details page of the portal. This page displays the name of each deployed module, as well as useful information like the deployment status and exit code.

Next steps

Learn how to Deploy and monitor IoT Edge modules at scale