Implementación de módulos de Azure IoT Edge desde Azure Portal

Se aplica a: IoT Edge 1.5 IoT Edge 1.4

Importante

IoT Edge 1.5 LTS e IoT Edge 1.4 LTS son versiones compatibles. IoT Edge 1.4 LTS finaliza el ciclo de vida el 12 de noviembre de 2024. Si está usando una versión anterior, consulte Actualización de IoT Edge.

Importante

A partir del 28 de agosto de 2024, Azure Marketplace actualiza el modelo de distribución de los módulos IoT Edge. Los socios (editores de módulos) comenzarán a alojar sus módulos IoT Edge en registros de contenedores propiedad de los editores. Las imágenes del módulo IoT Edge no estarán disponibles para su descarga desde el registro de contenedores de Azure Marketplace.

Póngase en contacto con el editor del módulo IoT Edge para obtener el URI de imagen de contenedor actualizado y actualice las configuraciones de sus dispositivos IoT Edge con el nuevo URI de imagen proporcionado por el editor.

Los dispositivos IoT Edge que no utilizan módulos de socios adquiridos en Azure Marketplace no se ven afectados y no es necesario tomar ninguna medida.

Una vez que ha creado módulos de IoT Edge con su lógica empresarial, querrá implementarlos en sus dispositivos para usarlos en el perímetro. Si tiene varios módulos que funcionan conjuntamente para recopilar y procesar datos, puede implementarlos todos a la vez y declarar las reglas de enrutamiento que los conectan.

Este artículo muestra cómo le puede ayudar Azure Portal en la creación de un manifiesto de implementación y en la inserción de la implementación en un dispositivo de IoT Edge. Para obtener información sobre la creación de una implementación dirigida a varios dispositivos en función de sus etiquetas compartidas, consulte Implementación y supervisión de módulos de IoT Edge a escala.

Requisitos previos

• Una instancia de IoT Hub en su suscripción de Azure.

• Un dispositivo IoT Edge.

  Si no tiene un dispositivo IoT Edge configurado, puede crear uno en una máquina virtual de Azure. Siga los pasos de alguno de los artículos de inicio rápido para Crear un dispositivo virtual Linux o Crear un dispositivo virtual Windows.

Configuración de un manifiesto de implementación

Un manifiesto de implementación es un documento JSON que describe qué módulos se van a implementar, cómo fluyen los datos entre los módulos y las propiedades deseadas de los módulos gemelos. Para más información sobre los manifiestos de implementación y cómo crearlos, consulte Descripción de cómo se pueden utilizar, configurar y reutilizar los módulos de IoT Edge.

Azure Portal tiene un asistente que le guía en la creación del manifiesto de implementación, en lugar de crear el documento JSON de forma manual. Consta de tres pasos: Adición de módulos, Especificación de rutas y Revisión de la implementación.

Nota:

En los pasos de este artículo se refleja la última versión de esquema del agente y el centro de conectividad de IoT Edge. La versión de esquema 1.1 se ha publicado junto con la versión 1.0.10 de IoT Edge y habilita las características de orden de inicio y priorización de rutas del módulo.

Si va a realizar la implementación en un dispositivo que ejecuta la versión 1.0.9 o anterior, edite Configuración del entorno de ejecución en el paso Módulos del asistente para usar la versión de esquema 1.0.

Selección de dispositivo y adición de módulos

1. Inicie sesión en Azure Portal y vaya a su instancia de IoT Hub.

2. En el panel izquierdo, seleccione Dispositivos en el menú Administración de dispositivos.

3. En la lista, seleccione el dispositivo de IoT Edge de destino.

4. En la barra superior, seleccione Establecer módulos.

5. En la sección Credenciales de Container Registry de la página, especifique las credenciales necesarias para acceder a los registros de contenedor que contienen las imágenes del módulo. Por ejemplo, los módulos están en el registro de contenedor privado o usa un registro de contenedor asociado que requiere autenticación.

6. En la sección Módulos de IoT Edge de la página, haga clic en Agregar.

   

7. Elija en el menú desplegable el tipo de módulos que desea agregar. Puede agregar módulos IoT Edge o módulos Azure Stream Analytics.

Módulo IoT Edge

Use esta opción para agregar módulos de Microsoft, módulos de asociados o módulos personalizados. Especifique el nombre del módulo y el identificador URI de la imagen de contenedor. El identificador URI de la imagen de contenedor es la ubicación de la imagen del módulo en un registro de contenedor. Para obtener una lista de imágenes de módulo Microsoft IoT Edge, consulte el Registro de artefactos de Microsoft. En el caso de los módulos de los asociados, póngase en contacto con el editor del módulo IoT Edge para obtener el identificador URI de la imagen de contenedor.

Por ejemplo, para agregar el módulo del sensor de temperatura simulado de Microsoft:

1. Escriba la siguiente configuración:

   Configuración	Valor
   URI de imagen	mcr.microsoft.com/azureiotedge-simulated-temperature-sensor
   Directiva de reinicio	Siempre
   Estado deseado	en ejecución

   

2. Seleccione Agregar.

3. Después de agregar un módulo, seleccione el nombre del módulo en la lista para abrir la configuración del módulo. Rellene los campos opcionales si es necesario.

   

Para más información sobre la configuración de módulos disponible, consulte Configuración y administración del módulo.

Para obtener más información sobre el módulo gemelo, consulte Definir o actualizar las propiedades deseadas.

Módulo de Azure Stream Analytics

Use esta opción para los módulos generados a partir de una carga de trabajo de Azure Stream Analytics.

1. Seleccione la suscripción y el trabajo Edge de Azure Stream Analytics que creó.
2. Seleccione Guardar.

Para más información sobre la implementación de Azure Stream Analytics en un módulo IoT Edge, consulte Tutorial: Implementación de Azure Stream Analytics como módulo IoT Edge.

Especificación de rutas

En la pestaña Rutas, se define cómo se pasan los mensajes entre los módulos de IoT Hub. Los mensajes se construyen mediante pares de nombre-valor. De forma predeterminada, la primera implementación de un nuevo dispositivo incluye una ruta denominada route y definida como FROM /messages/ INTO $upstream, lo que significa que cualquier salida de mensajes de cualquier módulo se envía al centro de IoT.

Los parámetros Priority y Time to live son parámetros opcionales que puede incluir en una definición de ruta. El parámetro Prioridad permite elegir las rutas cuyos mensajes se van a procesar primero o en último lugar. La prioridad se determina mediante un número de 0 a 9, donde 0 es la prioridad máxima. El parámetro Período de vida permite declarar durante cuánto tiempo se deben conservar los mensajes de esa ruta hasta que se procesan o se quitan de la cola.

Para más información sobre cómo crear rutas, consulte Declaración de rutas.

Una vez establecidas las rutas, seleccione Siguiente: Revisar y crear para continuar con el paso siguiente del asistente.

Revisión de la implementación

La sección de revisión le muestra el manifiesto de implementación en formato JSON que se ha creado en función de las selecciones de las dos secciones anteriores. Observe que hay dos módulos declarados que no ha agregado: $edgeAgent y $edgeHub. Estos dos módulos constituyen el entorno de ejecución de Azure IoT Edge y son valores predeterminados necesarios en todas las implementaciones.

Revise la información de implementación y seleccione Crear.

Visualización de módulos en el dispositivo

Una vez que los módulos se han implementado en el dispositivo, puede verlos todos en la página Detalles del dispositivo de IoT Hub. Esta página muestra el nombre de cada módulo implementado, así como información útil, como el estado de la implementación y el código de salida.

Seleccione Siguiente: Rutas y continúe con la implementación, tal y como se describe en Especificación de rutas y Revisión de la implementación anteriormente en este artículo.

Pasos siguientes

Obtenga información sobre cómo Implementar y supervisar módulos IoT Edge a escala.