Skip to content

Commit 4d83971

Browse files
committed
Metadata and links updated, minor Acrolinx fixes to improve score
1 parent f2f730c commit 4d83971

File tree

1 file changed

+15
-15
lines changed

1 file changed

+15
-15
lines changed

articles/iot-edge/how-to-deploy-modules-portal.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
22
title: Deploy modules from Azure portal - Azure IoT Edge
3-
description: Use your IoT Hub in the Azure portal to push an IoT Edge module from your IoT Hub to your IoT Edge device, as configured by a deployment manifest.
3+
description: Use your IoT hub in the Azure portal to push an IoT Edge module from your IoT hub to your IoT Edge device, as configured by a deployment manifest.
44
author: PatAltimore
55

66
ms.author: patricka
7-
ms.date: 06/12/2024
7+
ms.date: 05/05/2025
88
ms.topic: how-to
99
ms.service: azure-iot-edge
1010
services: iot-edge
@@ -15,41 +15,41 @@ services: iot-edge
1515
[!INCLUDE [iot-edge-version-all-supported](includes/iot-edge-version-all-supported.md)]
1616

1717
> [!IMPORTANT]
18-
> Starting August 28th 2024, Azure Marketplace is updating the distribution model for IoT Edge modules. Partners (module publishers) will begin [hosting their IoT Edge modules](https://azuremarketplace.microsoft.com/marketplace/apps/category/internet-of-things?subcategories=iot-edge-modules&filters=partners&page=1) on publisher-owned container registries. IoT Edge module images won't be available for download from the Azure Marketplace container registry.
18+
> Starting August 28, 2024, Microsoft Azure Marketplace is updating the distribution model for IoT Edge modules. Partners (module publishers) begin [hosting their IoT Edge modules](https://azuremarketplace.microsoft.com/marketplace/apps/category/internet-of-things?subcategories=iot-edge-modules&filters=partners&page=1) on publisher-owned container registries. IoT Edge module images aren't available for download from the container registry for Azure Marketplace.
1919
>
2020
> Contact the [IoT Edge module publisher](https://azuremarketplace.microsoft.com/marketplace/apps/category/internet-of-things?filters=partners&subcategories=iot-edge-modules&page=1) to obtain the updated container image URI and [update your IoT Edge device configurations](how-to-update-iot-edge.md#update-partner-module-uris) with the new image URI provided by the publisher.
2121
>
2222
> IoT Edge devices that don't use [partner modules](https://azuremarketplace.microsoft.com/marketplace/apps/category/internet-of-things?filters=partners&page=1&subcategories=iot-edge-modules) acquired from Azure Marketplace aren't affected and no action is required.
2323
2424
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.
2525

26-
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](how-to-deploy-at-scale.md).
26+
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 IoT Edge modules at scale using the Azure portal](how-to-deploy-at-scale.md).
2727

2828
## Prerequisites
2929

30-
* An [IoT Hub](../iot-hub/iot-hub-create-through-portal.md) in your Azure subscription.
30+
* An [IoT hub](../iot-hub/iot-hub-create-through-portal.md) in your Azure subscription.
3131
* An IoT Edge device.
3232

33-
If you don't have an IoT Edge device set up, you can create one in an Azure virtual machine. Follow the steps in one of the quickstart articles to [Create a virtual Linux device](quickstart-linux.md) or [Create a virtual Windows device](quickstart.md).
33+
If you don't have an IoT Edge device set up, you can create one in an Azure virtual machine. Follow the steps in one of the quickstart articles to [create a virtual Linux device](quickstart-linux.md) or [create a virtual Windows device](quickstart.md).
3434

3535
## Configure a deployment manifest
3636

37-
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](module-composition.md).
37+
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 [Learn how to deploy modules and establish routes in IoT Edge](module-composition.md).
3838

3939
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**.
4040

4141
>[!NOTE]
4242
>The steps in this article reflect the latest schema version of the IoT Edge agent and hub. Schema version 1.1 was released along with IoT Edge version 1.0.10, and enables the module startup order and route prioritization features.
4343
>
44-
>If you are deploying to a device running version 1.0.9 or earlier, edit the **Runtime Settings** in the **Modules** step of the wizard to use schema version 1.0.
44+
>If you're deploying to a device running version 1.0.9 or earlier, edit the **Runtime Settings** in the **Modules** step of the wizard to use schema version 1.0.
4545
4646
### Select device and add modules
4747

48-
1. Sign in to the [Azure portal](https://portal.azure.com) and navigate to your IoT Hub.
48+
1. Sign in to the [Azure portal](https://portal.azure.com) and navigate to your IoT hub.
4949
1. On the left pane, select **Devices** under the **Device management** menu.
5050
1. Select the target IoT Edge device from the list.
5151
1. On the upper bar, select **Set Modules**.
52-
1. In the **Container Registry Credentials** section of the page, provide credentials to access container registries that contain module images. For example, your modules are in your private container registry or you are using a partner container registry that requires authentication.
52+
1. In the **Container Registry Credentials** section of the page, provide credentials to access container registries that contain module images. For example, your modules are in your private container registry or you're using a partner container registry that requires authentication.
5353
1. In the **IoT Edge Modules** section of the page, select **Add**.
5454

5555
:::image type="content" source="media/how-to-deploy-modules-portal/set-modules-add.png" alt-text="Screenshot of selecting add IoT Edges modules toolbar button in the Azure portal.":::
@@ -92,7 +92,7 @@ For more information about deploying Azure Stream Analytics in an IoT Edge modul
9292

9393
### Specify routes
9494

95-
On the **Routes** tab, you define how messages are passed between modules and the IoT Hub. Messages are constructed using name/value pairs. By default, the first deployment for a new device includes a route called **route** and defined as **FROM /messages/\* INTO $upstream**, which means that any messages output by any modules are sent to your IoT Hub.
95+
On the **Routes** tab, you define how messages are passed between modules and the IoT hub. Messages are constructed using name/value pairs. By default, the first deployment for a new device includes a route called **route** and defined as **FROM /messages/\* INTO $upstream**, which means that any messages output by any modules are sent to your IoT hub.
9696

9797
The **Priority** and **Time to live** parameters are optional parameters that you can include in a route definition. The priority parameter allows you to choose which routes should have their messages processed first, or which routes should be processed last. Priority is determined by setting a number 0-9, where 0 is top priority. The time to live parameter allows you to declare how long messages in that route should be held until they're either processed or removed from the queue.
9898

@@ -102,16 +102,16 @@ Once the routes are set, select **Next: Review + create** to continue to the nex
102102

103103
### Review deployment
104104

105-
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](iot-edge-runtime.md) and are required defaults in every deployment.
105+
The review section shows you the JSON deployment manifest that was created based on your selections in the previous two sections. There are two modules declared that you didn't add: **$edgeAgent** and **$edgeHub**. These two modules make up the [IoT Edge runtime](iot-edge-runtime.md) and are required defaults in every deployment.
106106

107107
Review your deployment information, then select **Create**.
108108

109109
## View modules on your device
110110

111-
Once you've deployed modules to your device, you can view all of them in the device details page of your IoT Hub. This page displays the name of each deployed module, as well as useful information like the deployment status and exit code.
111+
Once you deploy modules to your device, you can view all of them in the device details page of your IoT hub. This page displays the name of each deployed module, and useful information like the deployment status and exit code.
112112

113-
Select **Next: Routes** and continue with deployment as described by [Specify routes](#specify-routes) and [Review Deployment](#review-deployment) earlier in this article.
113+
Select **Next: Routes** and continue with deployment as described by [Specify routes](#specify-routes) and [Review deployment](#review-deployment) earlier in this article.
114114

115115
## Next steps
116116

117-
Learn how to [Deploy and monitor IoT Edge modules at scale](how-to-deploy-at-scale.md).
117+
Learn how to [Deploy IoT Edge modules at scale using the Azure portal](how-to-deploy-at-scale.md).

0 commit comments

Comments
 (0)