Tutorial: Desarrollo de módulos IoT Edge para contenedores de Linux

Se aplica a: IoT Edge 1.1 IoT Edge 1.2

Use Visual Studio Code para desarrollar e implementar código en dispositivos en que se ejecute IoT Edge.

En el inicio rápido, creó un dispositivo IoT Edge e implementó un módulo desde Azure Marketplace. En este tutorial se explica cómo desarrollar e implementar código propio en un dispositivo IoT Edge. Este artículo es un requisito previo útil para los restantes tutoriales, en los que se proporcionarán más detalles acerca de lenguajes de programación o servicios de Azure concretos.

En este tutorial se usa el ejemplo de cómo implementar un módulo de C# en un dispositivo Linux. Este ejemplo se ha elegido porque es el escenario de desarrollador más común para las soluciones de IoT Edge. Incluso si planea usar otro lenguaje o implementar un servicio de Azure, este tutorial sigue siendo útil para aprender sobre los conceptos y las herramientas de desarrollo. Complete esta introducción al proceso de desarrollo y, después, elija su lenguaje preferido o el servicio de Azure que prefiera para profundizar en los detalles.

En este tutorial, aprenderá a:

Prerrequisitos

Una máquina de desarrollo:

• Puede usar su propio equipo o una máquina virtual, según sus preferencias de desarrollo.
  • Asegúrese de que el equipo de desarrollo admite la virtualización anidada. Esta funcionalidad es necesaria para ejecutar un motor de contenedor, que se instala en la sección siguiente.
• La mayor parte de los sistemas operativos que pueden ejecutar un motor de contenedor se pueden usar para desarrollar módulos IoT Edge para dispositivos Linux. En este tutorial se usa un equipo Windows, pero se indican las diferencias conocidas con macOS o Linux.
• Instale Git para extraer paquetes de plantillas de módulos más adelante.
• Extensión de C# para Visual Studio Code (con tecnología de OmniSharp)
• SDK de .NET Core 2.1.

Un dispositivo de Azure IoT Edge:

• Se recomienda no ejecutar IoT Edge en la máquina de desarrollo, sino usar un dispositivo independiente. Esta distinción entre la máquina de desarrollo y el dispositivo IoT Edge refleja con mayor precisión un verdadero escenario de implementación y ayuda a tener claros los distintos conceptos.
• Si no tiene un segundo dispositivo disponible, use el artículo del inicio rápido para crear un dispositivo IoT Edge en Azure con una máquina virtual Linux.

Recursos en la nube:

• Una instancia de IoT Hub de nivel estándar o gratis en Azure.

Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

Conceptos clave

En este tutorial se realiza un recorrido por el desarrollo de un módulo IoT Edge. Un módulo IoT Edge, o a veces simplemente módulo para abreviar, es un contenedor con código ejecutable. En un dispositivo IoT Edge se pueden implementar uno o varios módulos. Los módulos realizan tareas concretas, como la ingesta de datos de sensores, la limpieza y el análisis de datos, o el envío a un centro de IoT. Para más información, consulte Información sobre los módulos Azure IoT Edge.

Cuando se desarrollan módulos IoT Edge, es importante conocer la diferencia entre la máquina de desarrollo y el dispositivo IoT Edge de destino en el que finalmente se implementará el módulo. El contenedor que cree para contener el código del módulo debe coincidir con el sistema operativo del dispositivo de destino. Por ejemplo, el escenario más común es que alguien desarrolle un módulo en un equipo Windows que pretende tener como destino un dispositivo Linux en el que se ejecuta IoT Edge. En ese caso, el sistema operativo del contenedor sería Linux. A medida que avance en este tutorial, tenga en cuenta la diferencia entre el sistema operativo de la máquina de desarrollo y el sistema operativo del contenedor.

Este tutorial va dirigido a dispositivos de destino que ejecutan IoT Edge con contenedores de Linux. Puede usar el sistema operativo que prefiera, siempre que dicha máquina ejecute contenedores Linux. Se recomienda usar Visual Studio Code para desarrollar con contenedores de Linux, así que es lo que se va a usar en este tutorial. También se puede usar Visual Studio, aunque hay diferencias en lo relativo a la compatibilidad entre ambas herramientas.

En la tabla siguiente se enumeran los escenarios de desarrollo compatibles con los contenedores de Linux en Visual Studio Code y Visual Studio.

En este tutorial se enseñan los pasos del desarrollo en Visual Studio Code. Si prefiere usar Visual Studio, consulte las instrucciones de Uso de Visual Studio 2019 para desarrollar y depurar los módulos Azure IoT Edge.

Instalación de un motor de contenedor

Los módulos IoT Edge se empaquetan como contenedores, por lo que necesita un motor de contenedor en la máquina de desarrollo para crear y administrar los contenedores. Se recomienda Docker Desktop para el desarrollo debido a su popularidad y la compatibilidad de las características. Docker Desktop en Windows permite cambiar entre contenedores Linux y Windows para poder desarrollar fácilmente módulos para los distintos tipos de dispositivos IoT Edge.

Use la documentación de Docker para realizar la instalación en la máquina de desarrollo:

• Instalación de Docker Desktop para Windows

  • Cuando se instala Docker Desktop para Windows, se le pregunta si desea utilizar contenedores de Linux o de Windows. Esta decisión se puede cambiar en cualquier momento mediante un cambio fácil. En este tutorial se usan contenedores Linux porque nuestros módulos van dirigidos a dispositivos Linux. Para más información, consulte Switch between Windows and Linux containers (Cambio entre contenedores de Windows y Linux).

• Instalación de Docker Desktop para Mac

• Lea Acerca de CE de Docker para obtener información acerca de la instalación en varias plataformas Linux.

  • En el caso del Subsistema de Windows para Linux (WSL), instale Docker Desktop para Windows.

Configuración de VS Code y de herramientas

Use las extensiones de IoT para Visual Studio Code para desarrollar módulos IoT Edge. Estas extensiones proporcionan plantillas de proyecto, automatizan la creación del manifiesto de implementación y permiten supervisar y administrar dispositivos IoT Edge. En esta sección, se instalan Visual Studio Code y la extensión de IoT y luego se configurar una cuenta de Azure para administrar recursos de IoT Hub desde dentro de Visual Studio Code.

1. Instale Visual Studio Code en la máquina de desarrollo.

2. Una vez que finalice la instalación, seleccione Ver > Extensiones.

3. Busque Azure IoT Tools, que es realmente una colección de extensiones que le ayudan a interactuar con dispositivos IoT e IoT Hub, así como desarrollar módulos IoT Edge.

4. Seleccione Instalar. Cada extensión incluida se instala individualmente.

5. Cuando las extensiones se realizan mediante la instalación, abra la paleta de comandos, para lo que debe seleccionar Ver > Paleta de comandos.

6. En la paleta de comandos, busque y seleccione Azure: Iniciar sesión. Siga las indicaciones para iniciar sesión en su cuenta de Azure.

7. En la paleta de comandos, busque y seleccione Azure IoT Hub: Select IoT Hub (Azure IoT Hub: seleccione IoT Hub). Siga las instrucciones para seleccionar una suscripción de Azure y un centro de IoT.

8. Abra la sección del explorador de Visual Studio Code, para lo que puede seleccionar el icono pertinente en la barra de actividad de la izquierda, o bien seleccionar Ver > Explorador.

9. En la parte inferior de dicha sección, expanda el menú Azure IoT Hub / Devices (Azure IoT Hub/Dispositivos). Debería ver los dispositivos y los dispositivos IoT Edge asociados con el centro de IoT que seleccionó en la paleta de comandos.

   

Creación de un Registro de contenedor

En este tutorial se usa la extensión de Azure IoT Tools para fin de compilar un módulo y crear una imagen de contenedor a partir de los archivos. Después, insertará esta imagen en un Registro donde se almacenan y administran las imágenes. Por último, implementará la imagen en el Registro para que se ejecute en el dispositivo IoT Edge.

Puede usar cualquier registro compatible con Docker para almacenar las imágenes de contenedor. Dos de los servicios de registro de Docker más conocidos son Azure Container Registry y Docker Hub. En este tutorial, utilizaremos Azure Container Registry.

Si no dispone de un registro de contenedores, siga estos pasos para crear uno nuevo en Azure:

1. En Azure Portal, seleccione Crear un recurso > Contenedores > Container Registry.

2. Especifique los siguientes valores para crear un registro de contenedor:

   Campo	Value
   Suscripción	Seleccione una suscripción en la lista desplegable.
   Resource group	Se recomienda usar el mismo grupo de recursos para todos los recursos de prueba que se crean en las guías de inicio rápido y los tutoriales de IoT Edge. Por ejemplo, IoTEdgeResources.
   Nombre de registro	Especifique un nombre único.
   Location	Elija una ubicación cercana a usted.
   SKU	Seleccione Básica.

3. Seleccione Crear.

4. Una vez creado el registro de contenedor, vaya a él y, en el panel izquierdo, seleccione Claves de acceso en el menú que se encuentra en Configuración.

5. Haga clic para permitir que el usuario administrador pueda ver el nombre de usuario y la contraseña del registro de contenedor.

6. Copie los valores de Servidor de inicio de sesión, Nombre de usuario y Contraseña, y guárdelos en cualquier lugar que le resulte práctico. Dichos valores se usan en todo el tutorial para proporcionar acceso al registro de contenedor.

   

Creación de un nuevo proyecto de módulo

La extensión Azure IoT Tools proporciona plantillas de proyecto para todos los lenguajes del módulo IoT Edge admitidos que haya en Visual Studio Code. Estas plantillas tienen todos los archivos y el código que se necesita para implementar un módulo de trabajo y probar IoT Edge o le proporcionan a un punto de partida para personalizar la plantilla con su propia lógica de negocios.

En este tutorial, usamos la plantilla del módulo de C# porque es la plantilla que se usa con más frecuencia.

Creación de una plantilla de proyecto

En la paleta de comandos de Visual Studio Code, busque y seleccione Azure IoT Edge: New IoT Edge solution (Nueva solución de IoT Edge). Siga las instrucciones y use los siguientes valores para crear la solución:

Cuando la nueva solución se cargue en la ventana de Visual Studio Code, dedique unos minutos a familiarizarse con los archivos que ha creado:

• La carpeta .vscode contiene un archivo denominado launch.json, que se usa para la depuración de módulos.

• La carpeta modules contiene una carpeta para cada módulo de la solución. En este momento, solo debería ser SampleModule, o el nombre que haya dado al módulo. La carpeta SampleModule contiene el código de programa principal, los metadatos del módulo y varios archivos de Docker.

• El archivo .env almacena las credenciales en el registro de contenedor. Estas credenciales se comparten con el dispositivo IoT Edge para que tenga acceso para extraer las imágenes de contenedor.

• Tanto el archivo deployment.debug.template.json como el archivo deployment.template.json son plantillas que le ayudan a crear un manifiesto de implementación. Un manifiesto de implementación es un archivo que define exactamente qué módulos se desean implementar en un dispositivo, cómo se deben configurar y cómo se pueden comunicar tanto entre sí como con la nube. Los archivos de la plantilla utilizan punteros para algunos valores. Cuando la plantilla se transforma en un verdadero manifiesto de implementación, los punteros se reemplazan por valores que se han tomado de otros archivos de solución. Busque los dos marcadores de posición comunes en la plantilla de implementación:

  • En la sección de credenciales del registro, la dirección se rellena automáticamente a partir de la información que proporcionó al crear la solución. Sin embargo, el nombre de usuario y la contraseña hacen referencia a las variables almacenadas en el archivo .env. Esta configuración es por motivos de seguridad, ya que Git ignora el archivo .env, pero no sucede lo mismo con la plantilla de implementación.
  • En la sección SampleModule, la imagen de contenedor no se rellena, aunque haya especificado el repositorio de imágenes al crear la solución. Este marcador de posición apunta al archivo module.json de la carpeta SampleModule. Si va a dicho archivo, verá que el campo de imagen contiene el repositorio, sino también un valor de etiqueta, que se compone de la versión y la plataforma del contenedor. La versión se puede iterar manualmente como parte del ciclo de desarrollo y se puede seleccionar la plataforma de contenedor mediante un modificador que se presentará en esta misma sección más adelante.

Establecimiento de la versión del entorno de ejecución de IoT Edge

La extensión de IoT Edge adopta como predeterminada la versión estable más reciente del entorno de ejecución de IoT Edge cuando crea los recursos de implementación. Actualmente, la versión estable más reciente es la versión 1.2. Si va a desarrollar módulos para dispositivos que ejecutan la versión de compatibilidad a largo plazo 1.1 o la versión 1.0 anterior, actualice la versión del entorno de ejecución de IoT Edge en Visual Studio Code para que coincidan.

1. Seleccione Ver > Paleta de comandos.

2. En la paleta de comandos, escriba el comando Azure IoT Edge: Set default IoT Edge runtime version (Azure IoT Edge: Establecer la versión predeterminada del entorno de ejecución de IoT Edge) y ejecútelo.

3. En la lista, elija la versión del entorno de ejecución que ejecutan los dispositivos IoT Edge.

Después de seleccionar una nueva versión del entorno de ejecución, el manifiesto de implementación se actualiza dinámicamente para reflejar el cambio en las imágenes del módulo del entorno de ejecución.

Especificación de la credenciales del registro para el agente de IoT Edge

El archivo del entorno almacena las credenciales del registro de contenedor y las comparte con el runtime de IoT Edge. El entorno de ejecución necesita estas credenciales para extraer las imágenes de contenedor e insertarlas en el dispositivo IoT Edge.

La extensión de IoT Edge intenta extraer de Azure las credenciales del registro del contenedor y rellenar con ellas el archivo de entorno. Compruebe si las credenciales ya están incluidas. Si no lo están, agréguelas ahora:

1. Abra el archivo .env en la solución del módulo.
2. Agregue los valores de nombre de usuario y contraseña que ha copiado del registro de contenedor de Azure.
3. Guarde los cambios en el archivo .env.

Selección de la arquitectura de destino

Actualmente, Visual Studio Code puede desarrollar módulos de C# para dispositivos Linux AMD64 y ARM32v7. Debe seleccionar qué arquitectura tiene como destino con cada solución, ya que ello afecta a la forma en que se crea y ejecuta el contenedor. La opción predeterminada es Linux AMD64.

1. Abra la paleta de comandos y busque Azure IoT Edge: Set Default Target Platform for Edge Solution (Establecer la plataforma de destino predeterminada para la solución perimetral), o bien seleccione el icono de acceso directo en la barra lateral en la parte inferior de la ventana.

   

2. En la paleta de comandos, seleccione la arquitectura de destino en la lista de opciones. Para este tutorial, usamos una máquina virtual Ubuntu como dispositivo IoT Edge, por lo que mantendrá el valor predeterminado amd64.

Revisión del código de ejemplo

La plantilla de solución que ha creado incluye código de ejemplo de un módulo IoT Edge. Dicho módulo simplemente recibe los mensajes y, después, los pasa. La funcionalidad de canalización muestra un concepto importante de IoT Edge, cómo se comunican los módulos entre sí.

Cada módulo puede tener varias colas de entrada y salida declaran en su código. El centro de IoT Edge que se ejecuta en el dispositivo enruta los mensajes de la salida de un módulo en la entrada de uno o varios módulos. El código específico para declarar las entradas y salidas varía de un lenguaje a otro, pero el concepto es el mismo en todos los módulos. Para más información acerca del enrutamiento entre módulos, consulte Declaración de rutas.

El código de C# de ejemplo que acompaña a la plantilla del proyecto usa la clase ModuleClient del SDK de IoT Hub para .NET.

1. Abra el archivo Program.cs, que está dentro de la carpeta modules/SampleModule/ .

2. En program.cs, busque el método SetInputMessageHandlerAsync.

3. El método SetInputMessageHandlerAsync configura una cola de entrada para recibir los mensajes entrantes. Revise este método y vea cómo inicializa una cola de entrada llamada input1.

   

4. Luego, busque el método SendEventAsync.

5. El método SendEventAsync procesa los mensajes recibidos y configura una cola de salida para difundirlos. Revise dicho método y verá que inicializa una cola de salida llamada output1.

   

6. Abra el archivo deployment.template.json.

7. Busque la propiedad modules de las propiedades deseadas de $edgeAgent.

   Debería haber dos módulos. Uno es el módulo SimulatedTemperatureSensor, que se incluye en todas las plantillas de forma predeterminada para proporcionar datos de temperatura simulados que se pueden usar para probar los módulos. El otro es el módulo SampleModule que creó como parte de esta solución.

8. En la parte inferior del archivo, busque las propiedades deseadas del módulo $edgeHub.

   Una de las funciones del módulo del centro de IoT Edge es enrutar mensajes entre todos los módulos de una implementación. Revise los valores de la propiedad routes. Una ruta, SampleModuleToIoTHub, usa un carácter comodín (* * _) para indicar cualquier mensaje que proceda de alguna cola de salida del módulo SampleModule. Estos mensajes se dirigen a _$upstream*, un nombre reservado que indica IoT Hub. La otra ruta, sensorToSampleModule, toma los mensajes que proceden del módulo SimulatedTemperatureSensor y los enruta a la cola de entrada input1, que ha visto que se inicializaba en el código de SampleModule.

   

Compilación e inserción de la solución

Ha revisado el código del módulo y la plantilla de implementación para conocer algunos conceptos clave de la implementación. Ya está listo para que compilar la imagen de contenedor SampleModule e insertarla en el registro de contenedor. Con la extensión de las herramientas de IoT para Visual Studio Code, este paso también genera el manifiesto de implementación en función de la información del archivo de plantilla y la información del módulo a partir de los archivos de la solución.

Inicio de sesión en Docker

Especifique las credenciales del registro de contenedor a Docker para que puede insertar la imagen de contenedor para que se almacene en el registro.

1. Abra el terminal integrado de Visual Studio Code, para lo que debe seleccionar Ver > Terminal.

2. Inicie sesión en Docker con las credenciales del registro de contenedor de Azure que guardó después de crear el registro.

   docker login -u <ACR username> -p <ACR password> <ACR login server>
   

   Puede recibir una advertencia de seguridad en la que se recomiende el uso de --password-stdin. Aunque ese procedimiento se recomienda para escenarios de producción, está fuera del ámbito de este tutorial. Para más información, consulte la referencia de docker login.

3. Inicio de sesión en Azure Container Registry

   az acr login -n <ACR registry name>
   

Compilación e inserción

Visual Studio Code ahora tiene acceso a su registro de contenedor, por lo que es el momento de convertir el código de la solución en una imagen de contenedor.

1. En el explorador de Visual Studio Code, haga clic con el botón derecho en el archivo deployment.template.json y seleccione Build and Push IoT Edge solution (Compilar e insertar solución IoT Edge).

   

   El comando de compilación e inserción inicia tres operaciones. En primer lugar, se crea una nueva carpeta en la solución denominada config que contiene los archivos del manifiesto de la implementación completa, con la información de la plantilla de implementación y otros archivos de la solución. En segundo lugar, ejecuta docker build para generar la imagen de contenedor basándose en el Dockerfile adecuado para la arquitectura de destino. A continuación, ejecuta docker push para insertar el repositorio de imágenes en el registro de contenedor.

   Este proceso puede tardar varios minutos la primera vez, pero es más rápido la próxima vez que ejecute los comandos.

2. Abra el archivo deployment.amd64.json en la carpeta de configuración recién creada. El nombre de archivo refleja la arquitectura de destino, por lo que será diferente si ha elegido una otra arquitectura.

3. Tenga en cuenta que los dos parámetros que tenían marcadores de posición ahora están rellenos con los valores adecuados. La sección registryCredentials tiene el nombre de usuario y la contraseña del registro que se extrajeron del archivo .env. SampleModule tiene el repositorio de imágenes completo con el nombre, la versión y la etiqueta de arquitectura del archivo module.json.

4. Abra el archivo module.json de la carpeta SampleModule.

5. Cambie el número de versión de la imagen del módulo. (la versión, no la versión $schema). Por ejemplo, incremente el número de versión de la revisión a 0.0.2 como si hubiéramos hecho una pequeña corrección en el código del módulo.

   Sugerencia

   Las versiones de los módulos permiten el control de versiones y le permiten probar los cambios en un pequeño conjunto de dispositivos antes de implementar actualizaciones en la producción. Si no incrementa la versión del módulo antes de la compilación e inserción, entonces sobrescribirá el repositorio en el registro de contenedor.

6. Guarde los cambios en el archivo module.json.

7. Vuelva a hacer clic con el botón derecho en el archivo deployment.template.json y seleccione Build and Push IoT Edge solution (Compilar e insertar solución IoT Edge) de nuevo.

8. Vuelva a abrir el archivo deployment.amd64.json de nuevo. Observe que no se creó un nuevo archivo cuando ejecutó el comando de compilación e inserción de nuevo. Más bien, el mismo archivo se actualizó para reflejar los cambios. La imagen de SampleModule ahora apunta a la versión 0.0.2 del contenedor.

9. Para comprobar mejor lo que hizo el comando de compilación e inserción, vaya a Azure Portal y navegue al registro de contenedor.

10. En el registro de contenedor, seleccione Repositorios y después samplemodule. Compruebe que ambas versiones de la imagen se hayan insertado en el registro.

    

Solución de problemas

Si encuentra errores al compilar e insertar la imagen del módulo, a menudo tiene que ver con la configuración de Docker en la máquina de desarrollo. Utilice las siguientes comprobaciones para revisar la configuración:

• ¿Ha ejecutado el comando docker login mediante las credenciales que copió del registro de contenedor? Estas credenciales son diferentes a las que se utilizan para iniciar sesión en Azure.
• ¿Es el repositorio de contenedor correcto? ¿Tiene el nombre correcto del registro de contenedor y el nombre correcto del módulo? Abra el archivo module.json de la carpeta SampleModule para comprobarlo. El valor del repositorio debería ser similar a <registry name>.azurecr.io/samplemodule.
• Si utilizó un nombre diferente a SampleModule para el módulo, ¿es coherente ese nombre en toda la solución?
• ¿La máquina funciona con el mismo tipo de contenedores que está creando? Este tutorial es para dispositivos IoT Edge de Linux, por lo que Visual Studio Code debería indicar amd64 o arm32v7 en la barra lateral y Docker Desktop debe ejecutar contenedores Linux.

Implementación de módulos en el dispositivo

Ha verificado que las imágenes de contenedor creadas se almacenan en el registro de contenedor, por lo que es el momento de implementarlas en un dispositivo. Asegúrese de que el dispositivo IoT Edge está en funcionamiento.

1. En el explorador de Visual Studio Code, en la sección Azure IoT Hub, expanda Dispositivos para ver la lista de dispositivos IoT.

2. Haga clic con el dispositivo IoT Edge que desea implementar y seleccione Create Deployment for IoT Edge device (Crear una implementación para un dispositivo individual).

   

3. En el Explorador de archivos, vaya a la carpeta config y seleccione el archivo deployment.amd64.json.

   No utilice el archivo deployment.template.json, que no contiene todos las credenciales del registro de contenedor o los valores de imagen del módulo. Si el destino es un dispositivo ARM32 con Linux, el manifiesto de implementación se denominará deployment.arm32v7.json.

4. En el dispositivo, expanda Módulos para ver una lista de módulos implementados y en ejecución. Haga clic en el botón Actualizar. Debería ver que los nuevos módulos SimulatedTemperatureSensor y SampleModule se ejecutan en el dispositivo.

   Los módulos pueden tardar unos minutos en iniciarse. El entorno de ejecución de Azure IoT Edge necesita recibir su nuevo manifiesto de implementación, extraer las imágenes de los módulos del entorno de ejecución del contenedor y, después, iniciar cada nuevo módulo.

   

Visualización de los mensajes desde el dispositivo

El código SampleModule recibe mensajes mediante la cola de entrada y los pasa por la cola de salida. El manifiesto de implementación declaraba las rutas que pasaban a SampleModule los mensajes de SimulatedTemperatureSensor, y luego reenviaba los mensajes de SampleModule a la instancia de IoT Hub. Las herramientas de Azure IoT para Visual Studio Code permiten ver los mensajes que llegan a IoT Hub desde dispositivos individuales.

1. En el explorador de Visual Studio Code, haga clic con el botón derecho en el dispositivo IoT Edge que desea supervisar y seleccione Start Monitoring Built-in Event Endpoint (Iniciar supervisión del punto de conexión del evento integrado).

2. En la ventana de salida podrá ver si llegan mensajes al centro de IoT.

   

Visualización de los cambios en el dispositivo

Si desea ver lo que está ocurriendo en su propio dispositivo, utilice los comandos de esta sección para inspeccionar el entorno de ejecución de Azure IoT Edge y los módulos que se ejecutan en el dispositivo.

Los comandos de esta sección son para el dispositivo IoT Edge, no en la máquina de desarrollo. Si usa una máquina virtual para el dispositivo IoT Edge, conéctese a ella ahora. En Azure, vaya a la página de información general de la máquina virtual y seleccione Conectar para acceder a la conexión de Secure Shell.

• Vea todos los módulos implementados en el dispositivo y compruebe su estado:

  iotedge list
  

  Debería ver cuatro módulos: los dos módulos personalizados del entorno de ejecución de IoT Edge, SimulatedTemperatureSensor y SampleModule. Los cuatro deben aparecer como en ejecución.

• Inspeccione los registros para un módulo específico:

  iotedge logs <module name>
  

  Los módulos IoT Edge distinguen mayúsculas de minúsculas.

  Los registros de SimulatedTemperatureSensor y SampleModule deben mostrar los mensajes que están procesando. El módulo edgeAgent es responsable de iniciar los otros módulos, por lo que sus registros tendrá información sobre cómo implementar el manifiesto de implementación. Si algún módulo no aparece en la lista o no se está ejecutando, es probable que los registros de edgeAgent contengan los errores. El módulo edgeHub es responsable de las comunicaciones entre los módulos e IoT Hub. Si los módulos están en funcionamiento, pero los mensajes no llegan al centro de IoT, los registros de edgeHub probablemente contendrán los errores.

Limpieza de recursos

Si prevé seguir con el siguiente artículo recomendado, puede mantener los recursos y las configuraciones que ya ha creado y volverlos a utilizar. También puede seguir usando el mismo dispositivo de IoT Edge como dispositivo de prueba.

En caso contrario, para evitar gastos, puede eliminar las configuraciones locales y los recursos de Azure que creó en este artículo.

Eliminación de recursos de Azure

La eliminación de los recursos de Azure y de los grupos de recursos es un proceso irreversible. Asegúrese de no eliminar por accidente el grupo de recursos o los recursos equivocados. Si ha creado el centro de IoT en un grupo de recursos ya existente que tiene recursos que desea conservar, elimine solo el recurso del centro de IoT en sí en lugar de eliminar todo el grupo de recursos.

Para eliminar los recursos:

1. Inicie sesión en Azure Portal y después seleccione Grupos de recursos.

2. Seleccione el nombre del grupo de recursos que contiene los recursos de prueba de IoT Edge.

3. Revise la lista de los recursos contenidos en el grupo de recursos. Si desea eliminar todos ellos, puede seleccionar Eliminar grupo de recursos. Si desea eliminar solo algunos de ellos, puede hacer clic en cada recurso para eliminarlos individualmente.

Pasos siguientes

En este tutorial, ha configurado Visual Studio Code en la máquina de desarrollo y ha implementado el primer módulo IoT Edge desde él. Ahora que conoce los conceptos básicos, intente agregar funcionalidad a un módulo para que pueda analizar los datos que pasan por él. Elija el lenguaje que prefiera: