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

Se aplica a: IoT Edge 1.5

Importante

IoT Edge 1.5 LTS es la versión compatible. IoT Edge 1.4 LTS finaliza su 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, Microsoft Azure Marketplace actualiza el modelo de distribución para los módulos de IoT Edge. Los asociados (publicadores de módulos) comienzan a hospedar sus módulos de IoT Edge en registros de contenedor propiedad del publicador. Las imágenes de módulo de IoT Edge no está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 cómo crear una implementación destinada a varios dispositivos en función de sus etiquetas compartidas, consulte Implementación de módulos de IoT Edge a escala mediante Azure Portal.

Requisitos previos

• Una instancia de IoT Hub en la 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 descritos en uno de los artículos de inicio rápido para crear un dispositivo Linux virtual o crear un dispositivo Windows virtual.

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 obtener más información sobre cómo funcionan los manifiestos de implementación y cómo crearlos, consulte Aprenda a implementar módulos y a establecer rutas en 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 implementar en un dispositivo que ejecuta la versión 1.0.9 o anterior, edite la configuración en tiempo de ejecución en el paso Módulos del asistente para usar la versión 1.0 del esquema.

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

1. Inicie sesión en Azure Portal y vaya al centro de IoT.

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 se 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 y el centro de IoT. 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 los mensajes que generan los módulos se envían a IoT Hub.

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. 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 implemente módulos en el dispositivo, puede ver todos ellos en la página de detalles del dispositivo de IoT Hub. En esta página se muestra el nombre de cada módulo implementado y información útil, como el estado de implementación y el código de salida.

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

Pasos siguientes

Aprenda a implementar módulos de IoT Edge a escala mediante Azure Portal.