Administración de manifiestos de implementación IoT Edge en la aplicación de IoT Central

Un manifiesto de implementación permite especificar los módulos que el entorno de ejecución de IoT Edge debe descargar y configurar. Un dispositivo IoT Edge puede descargar un manifiesto de implementación cuando se conecta por primera vez a la aplicación de IoT Central. En este artículo se describe cómo administrar manifiestos de implementación en la aplicación de IoT Central.

Para más información sobre IoT Edge e IoT Central, consulte Conexión de dispositivos de Azure IoT Edge a una aplicación de Azure IoT Central.

Para obtener información sobre cómo administrar manifiestos de implementación mediante la API de REST de IoT Central, consulte Uso de la API de REST de IoT Central para administrar manifiestos de implementación.

Administración de manifiestos de implementación

La página Manifiestos de Edge permite administrar los manifiestos de implementación en la aplicación. En esta página puede realizar las siguientes acciones:

• Carga o creación de manifiestos de implementación
• Modificación de manifiestos de implementación existentes
• Eliminación de manifiestos de implementación

Carga y creación de manifiestos de implementación

Al crear un nuevo manifiesto de implementación, puede cargar el archivo JSON del manifiesto de implementación o empezar con un manifiesto existente:

1. En la página Manifiestos de Edge, seleccione + Nuevo.

2. Escriba un nombre para el manifiesto de implementación.

3. Si la aplicación usa organizaciones, seleccione una organización con la que asociar el manifiesto de implementación.

4. Busque un archivo de manifiesto de implementación para cargar o elija un manifiesto de implementación existente como punto de partida para el nuevo. IoT Central valida los archivos cargados.

   

5. Seleccione Siguiente. La página Revisar y finalizar muestra información sobre el manifiesto de implementación y los módulos que define. También puede ver el JSON sin formato.

6. Seleccione Crear. La página Manifiestos de Edge ahora incluye el nuevo manifiesto de implementación.

Sugerencia

Si tiene un gran número de manifiestos de implementación, puede ordenar y filtrar la lista que se muestra en la página Manifiestos de Edge.

Edición del origen JSON de un manifiesto de implementación

Para modificar un manifiesto de implementación editando el archivo JSON directamente:

1. Vaya a la página Manifiestos de Edge.

2. Seleccione Editar JSON en el menú contextual del manifiesto de implementación que desea modificar.

3. Use el editor JSON para realizar los cambios necesarios. Después, seleccione Guardar.

Reemplazo del contenido de un manifiesto de implementación

Para reemplazar completamente el contenido de un manifiesto de implementación:

1. Vaya a la página Manifiestos de Edge.

2. Seleccione el manifiesto de implementación que desea reemplazar.

3. En el cuadro de diálogo Personalizar, busque un nuevo archivo de manifiesto de implementación para cargar o elija un manifiesto de implementación existente como punto de partida. IoT Central valida los archivos cargados.

4. Seleccione Siguiente. La página Revisar y finalizar muestra información sobre el nuevo manifiesto de implementación y los módulos que define. También puede ver el JSON sin formato.

5. Seleccione Guardar. La página Manifiestos de Edge ahora incluye el manifiesto de implementación actualizado.

Administración de dispositivos IoT Edge

Al agregar un dispositivo IoT Edge en la página de dispositivos, puede elegir un manifiesto de implementación para el dispositivo. En el cuadro de diálogo Crear un dispositivo, puede elegir entre la lista de manifiestos de dispositivo cargados previamente en la página Manifiestos de Edge. También es posible agregar un manifiesto de implementación directamente a un dispositivo después de crear el dispositivo.

Si agrega un dispositivo IoT Edge que no está asignado a una plantilla de dispositivo, el cuadro de diálogo Crear un nuevo dispositivo tiene el siguiente aspecto:

Para elegir el manifiesto de implementación del dispositivo:

1. Cambie ¿Dispositivo Azure IoT Edge? a Sí.

2. Seleccione el manifiesto de implementación de IoT Edge que se va a usar. También puede optar por asignar un manifiesto de implementación después de crear el dispositivo.

3. Seleccione Crear.

Si agrega un dispositivo IoT Edge asignado a una plantilla de dispositivo, el cuadro de diálogo Crear un nuevo dispositivo tendrá el siguiente aspecto:

Para elegir el manifiesto de implementación del dispositivo:

1. El botón de alternancia ¿Dispositivo Azure IoT Edge? ya está establecido en Sí porque IoT Central reconoce que usa una plantilla de dispositivo IoT Edge.

2. Seleccione el manifiesto de implementación de IoT Edge que se va a usar. También puede optar por asignar un manifiesto de implementación después de crear el dispositivo.

3. Seleccione Crear.

Cuando un dispositivo IoT Edge se conecta a la aplicación por primera vez, descarga el manifiesto de implementación, configura los módulos especificados en el manifiesto de implementación y ejecuta los módulos.

Si no selecciona un manifiesto de implementación al crear un dispositivo IoT Edge, puede asignar uno más adelante individualmente o a varios dispositivos mediante un trabajo.

Actualización del manifiesto de implementación que usa un dispositivo

Puede administrar el manifiesto de implementación de un dispositivo existente:

Use Asignar manifiesto de Edge para seleccionar un manifiesto de implementación cargado anteriormente en la página Manifiestos de Edge. También puede usar esta opción para notificar manualmente a un dispositivo si ha modificado el manifiesto de implementación en la página Manifiestos de Edge.

Use Editar manifiesto para modificar el manifiesto de implementación de este dispositivo. Los cambios que realice aquí no afectan al manifiesto de implementación en la página Manifiestos de Edge.

Trabajos

Para asignar o actualizar el manifiesto de implementación para varios dispositivos, use un trabajo. Use el tipo de trabajo Cambiar manifiesto de implementación perimetral:

Adición de módulos y propiedades a plantillas de dispositivo

Un manifiesto de implementación define los módulos que se van a ejecutar en el dispositivo y, opcionalmente, las propiedades grabables que puede usar para configurar módulos.

Si va a asignar una plantilla de dispositivo a un dispositivo IoT Edge, puede definir los módulos y las propiedades grabables en la plantilla de dispositivo. Para agregar los módulos y las definiciones de propiedad a una plantilla de dispositivo:

1. Vaya a la página Resumen de módulos de la plantilla de dispositivo IoT Edge.
2. Seleccione Importar módulos desde el manifiesto.
3. Seleccione el manifiesto de implementación adecuado de la lista.
4. Seleccione Import (Importar). IoT Central agrega los módulos personalizados definidos en el manifiesto de implementación a la plantilla de dispositivo. Los nombres de los módulos de la plantilla de dispositivo coinciden con los nombres de los módulos personalizados en el manifiesto de implementación. La interfaz generada incluye definiciones de propiedad para las propiedades definidas para el módulo personalizado en el manifiesto de implementación: