Implementación de módulos de Azure IoT Edge desde Visual Studio Code

Se aplica a: IoT Edge 1.5 IoT Edge 1.4

Importante

IoT Edge 1.5 LTS e IoT Edge 1.4 LTS se 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.

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.

En este artículo se muestra cómo crear un manifiesto de implementación de JSON y, luego, usar ese archivo para insertar la implementación en un dispositivo 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, vea Implementación de módulos de IoT Edge a escala con Visual Studio Code.

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 de alguno de los artículos de inicio rápido para Crear un dispositivo virtual Linux o Crear un dispositivo virtual Windows.

• Visual Studio Code.

• Azure IoT Edge para Visual Studio Code. La extensión de Herramientas de Azure IoT Edge para Visual Studio Code está en modo de mantenimiento.

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.

Para implementar módulos con Visual Studio Code, guarde el manifiesto de implementación localmente como un archivo .JSON. Usará la ruta de acceso al archivo en la sección siguiente, al ejecutar el comando para aplicar la configuración al dispositivo.

Este es un manifiesto de implementación básico con un módulo como ejemplo:

Nota:

Este manifiesto de implementación de ejemplo usa la versión de esquema 1.1 para el centro y el agente de IoT Edge. La versión de esquema 1.1 se publicó junto con la versión 1.0.10 de IoT Edge y habilita características como el orden de inicio y la priorización de rutas del módulo.

{
  "modulesContent": {
    "$edgeAgent": {
      "properties.desired": {
        "schemaVersion": "1.1",
        "runtime": {
          "type": "docker",
          "settings": {
            "minDockerVersion": "v1.25",
            "loggingOptions": "",
            "registryCredentials": {}
          }
        },
        "systemModules": {
          "edgeAgent": {
            "type": "docker",
            "settings": {
              "image": "mcr.microsoft.com/azureiotedge-agent:1.5",
              "createOptions": "{}"
            }
          },
          "edgeHub": {
            "type": "docker",
            "status": "running",
            "restartPolicy": "always",
            "settings": {
              "image": "mcr.microsoft.com/azureiotedge-hub:1.5",
              "createOptions": "{\"HostConfig\":{\"PortBindings\":{\"443/tcp\":[{\"HostPort\":\"443\"}],\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}]}}}"
            }
          }
        },
        "modules": {
          "SimulatedTemperatureSensor": {
            "version": "1.5",
            "type": "docker",
            "status": "running",
            "restartPolicy": "always",
            "settings": {
              "image": "mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.5",
              "createOptions": "{}"
            }
          }
        }
      }
    },
    "$edgeHub": {
      "properties.desired": {
        "schemaVersion": "1.1",
        "routes": {
            "route": "FROM /messages/* INTO $upstream"
        },
        "storeAndForwardConfiguration": {
          "timeToLiveSecs": 7200
        }
      }
    },
    "SimulatedTemperatureSensor": {
      "properties.desired": {}
    }
  }
}

Iniciar sesión para acceder a IoT Hub

Puede usar las extensiones de Azure IoT para Visual Studio Code para realizar operaciones con IoT Hub. Para que estas operaciones funcionen, debe iniciar sesión en su cuenta de Azure y seleccionar la instancia de IoT Hub en la que está trabajando.

1. En Visual Studio Code, abra la vista Explorer (Explorador).

2. En la parte inferior de Explorer, expanda la sección Azure IoT Hub.

   

3. Haga clic en los puntos suspensivos ... en el encabezado de la sección Azure IoT Hub. Si no ve el botón de los puntos suspensivos, mantenga el mouse sobre el encabezado.

4. Elija Select IoT Hub (Seleccionar IoT Hub).

5. Si no ha iniciado sesión en su cuenta de Azure, siga las indicaciones para hacerlo.

6. Seleccione su suscripción a Azure.

7. Seleccione IoT Hub.

Implementación en el dispositivo

Para implementar los módulos en el dispositivo, aplique el manifiesto de implementación que configuró con la información del módulo.

1. En la vista del explorador de Visual Studio Code, expanda la sección Azure IoT Hub y después el nodo Dispositivos.

2. Haga clic con el botón derecho en el dispositivo de IoT Edge que quiere configurar con el manifiesto de implementación.

   Sugerencia

   Para confirmar que el dispositivo que ha elegido es un dispositivo IoT Edge, selecciónelo para expandir la lista de módulos y comprobar la presencia de $edgeHub y $edgeAgent. Todos los dispositivos IoT Edge incluyen estos dos módulos.

3. Seleccione Create Deployment for Single Device (Crear una implementación para un dispositivo individual).

4. Vaya al archivo JSON de manifiesto de implementación que quiere usar y haga clic en Select Edge Deployment Manifest (Seleccionar manifiesto de implementación de Edge).

   

Los resultados de la implementación se imprimen en la salida de Visual Studio Code. Las implementaciones correctas se aplican a los pocos minutos si el dispositivo de destino está en ejecución y conectado a Internet.

Visualización de módulos en el dispositivo

Una vez que haya implementado los módulos en el dispositivo, puede verlos todos en la sección Azure IoT Hub. Seleccione la flecha situada junto a su dispositivo IoT Edge para expandirlo. Se muestran todos los módulos actualmente en ejecución.

Si ha implementado recientemente nuevos módulos en un dispositivo, mantenga el mouse sobre el encabezado de la sección Azure IoT Hub Devices (Dispositivos de Azure IoT Hub) y seleccione el icono de actualización para actualizar la vista.

Haga clic con el botón derecho en el nombre del módulo para ver y editar el módulo gemelo.

Pasos siguientes

Aprenda a implementar y supervisar módulos de IoT Edge a escala mediante Visual Studio Code