Tutorial: Actualización de dispositivos para Azure IoT Hub mediante el agente de referencia del simulador de Ubuntu (18.04 x64)

Device Update for IoT Hub admite actualizaciones basadas en imágenes, en paquetes y en scripts.

Las actualizaciones con imágenes proporcionan un mayor nivel de confianza en el estado final del dispositivo. Normalmente, es más fácil replicar los resultados de una actualización de imagen entre un entorno de preproducción y un entorno de producción porque no plantea los mismos desafíos que los paquetes y sus dependencias. Debido a su naturaleza atómica, también se puede adoptar fácilmente un modelo de conmutación por error A/B.

Este tutorial le guía por los pasos necesarios para completar una actualización basada en imágenes de un extremo a otro mediante Device Update para IoT Hub.

En este tutorial, aprenderá a:

Prerrequisitos

Si aún no lo ha hecho, cree una cuenta y una instancia de Device Update y configure un centro de IoT.

Descargue el archivo ZIP denominado Tutorial_Simulator.zip de Recursos de versión en la versión más reciente y descomprímalo.

Incorporación de un dispositivo a Azure IoT Hub

Después de ejecutar el agente de Device Update en un dispositivo IoT, debe agregar el dispositivo a IoT Hub. Desde IoT Hub, se genera una cadena de conexión para un dispositivo determinado.

1. En Azure Portal, inicie Device Update para IoT Hub.

2. Crea un nuevo dispositivo.

3. En el panel izquierdo, vaya a Dispositivos. A continuación, seleccione Nuevo.

4. En Id. de dispositivo, escriba un nombre para el dispositivo. Asegúrese de que la casilla Generación automática de claves esté activada.

5. Selecciona Guardar.

6. Volverá a la página Dispositivos y el dispositivo que ha creado debería estar en la lista. Seleccione ese dispositivo.

7. En la vista de dispositivo, seleccione el icono Copiar situado junto a Cadena de conexión principal.

8. Pegue los caracteres copiados en algún lugar para usarlos más adelante en los pasos siguientes:

   Esta cadena copiada es la cadena de conexión del dispositivo.

Instalación de un agente de Device Update para probarlo como un simulador

1. Siga las instrucciones para instalar el entorno de ejecución de Azure IoT Edge.

   Nota:

   El agente de Device Update no depende de IoT Edge. Pero depende del servicio IoT Identity Service que se instala con IoT Edge (1.2.0 y versiones posteriores) para obtener una identidad y conectarse al IoT Hub.

   Aunque no se trata en este tutorial, el demonio de IoT Identity Service se puede instalar de forma independiente en dispositivos IoT basados en Linux. La secuencia de instalación es importante. El agente de paquetes de Device Update debe instalarse después de IoT Identity Service. De lo contrario, el agente de paquetes no se registrará como un componente autorizado para establecer una conexión a IoT Hub.

2. A continuación, instale los paquetes .deb del agente de Device Update.

   sudo apt-get install deviceupdate-agent deliveryoptimization-plugin-apt 
   

3. Introduzca la cadena de conexión principal del módulo de su dispositivo IoT (o dispositivo, en función de cómo aprovisionó el dispositivo con Device Update) en el archivo de configuración ejecutando el siguiente comando:

   sudo nano /etc/adu/du-config.json
   

4. Configure el agente para que se ejecute como simulador. Ejecute el siguiente comando en el dispositivo IoT para que el agente de Device Update invoque al controlador del simulador para procesar una actualización de paquete con APT ("microsoft/apt:1"):

   sudo /usr/bin/AducIotAgent --register-content-handler /var/lib/adu/extensions/sources/libmicrosoft_simulator_1.so --update-type 'microsoft/apt:1'
   

   Para registrar e invocar el controlador del simulador, use el siguiente formato, rellenando los marcadores de posición:

   sudo /usr/bin/AducIotAgent --register--content-handler <full path to the handler file> --update-type <update type name>

5. Necesitará el archivo sample-du-simulator-data.json del Tutorial_Simulator.zip descargado como parte de los requisitos previos.

   Abra el archivo sample-du-simulator-data.json y copie el contenido en el Portapapeles:

   nano sample-du-simulator-data.json
   

   Seleccione el contenido del archivo y presione Ctrl+C. Presione Ctrl+X para cerrar el archivo y no guardar los cambios.

   Ejecute el siguiente comando para crear y editar el du-simulator-data.json archivo en la carpeta tmp:

   sudo nano /tmp/du-simulator-data.json
   

   Presione Ctrl+V para pegar el contenido en el editor. Seleccione Ctrl+X para guardar los cambios y, después, Y.

   Cambiar permisos:

   sudo chown adu:adu /tmp/du-simulator-data.json
   sudo chmod 664 /tmp/du-simulator-data.json
   

   Si /tmp no existe, haga lo siguiente:

    sudo mkdir/tmp
    sudo chown root:root/tmp
    sudo chmod 1777/tmp
   

6. Reinicie el agente de Device Update mediante la ejecución del comando siguiente:

    sudo systemctl restart adu-agent
   

Device Update para el software de Azure IoT Hub está sujeto a los siguientes términos de licencia:

• Licencia de Actualización de Dispositivos para IoT Hub
• Licencia de cliente de Optimización de distribución

Lea los términos de licencia antes de usar el agente. Su instalación y uso constituye su aceptación de estos términos. Si no está de acuerdo con los términos de licencia, no use el agente device Update para IoT Hub.

# sudo /usr/bin/AducIotAgent --register-content-handler /var/lib/adu/extensions/sources/libmicrosoft_apt_1.so --update-type 'microsoft/a pt:1'

Adición de una etiqueta al dispositivo

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

2. En Dispositivos en el panel izquierdo, encuentre su dispositivo IoT y acceda al dispositivo gemelo o al módulo gemelo.

3. En el módulo gemelo del agente de Device Update, cambie los valores de etiqueta de Device Update existentes a null para eliminarlos. Si usa la identidad del dispositivo con un agente de Device Update, realice estos cambios en el dispositivo gemelo.

4. Agregue un nuevo valor de etiqueta de Device Update como se muestra a continuación:

       "tags": {
               "ADUGroup": "<CustomTagValue>"
               }
   

Importación de la actualización

1. Necesitará los archivos TutorialImportManifest_Sim.importmanifest.json y adu-update-image-raspberrypi3.swu del descargado Tutorial_Simulator.zip en los requisitos previos. El archivo de actualización se reutiliza del tutorial de Raspberry Pi. Dado que la actualización de este tutorial está simulada, el contenido específico del archivo no importa.

2. Inicie sesión en el portal de Azure y vaya a su centro de IoT con Device Update. En el panel izquierdo, en Administración automática de dispositivos, seleccione Actualizaciones.

3. Seleccione la pestaña Actualizaciones.

4. Seleccione + Importar nueva actualización.

5. Seleccione + Seleccionar desde el contenedor de almacenamiento. Seleccione una cuenta existente o cree una nueva mediante + Cuenta de almacenamiento. A continuación, seleccione un contenedor existente o cree uno nuevo mediante + Contenedor. Este contenedor se usará para almacenar provisionalmente los archivos de actualización para la importación.

   Nota:

   Se recomienda usar un nuevo contenedor cada vez que importe una actualización para evitar la importación accidental de archivos de actualizaciones anteriores. Si no usa un contenedor nuevo, asegúrese de eliminar los archivos del contenedor existente antes de completar este paso.

   

6. En el contenedor, seleccione Cargar y vaya hasta los archivos que descargó en el paso 1. Después de seleccionar todos los archivos de actualización, seleccione Cargar. A continuación, seleccione el botón Seleccionar para volver a la página Importar actualización.

   

   En esta captura de pantalla se muestra el paso de importación. Es posible que los nombres de archivo no coincidan con los usados en el ejemplo.

7. En la página Importar actualización, revise los archivos que se importarán. A continuación, seleccione Importar actualización para iniciar el proceso de importación.

   

8. Se inicia el proceso de importación y la pantalla cambia a la sección Historial de importación. Cuando la columna Estado indique que la importación se ha realizado correctamente, seleccione el encabezado Available updates (Actualizaciones disponibles). Debería ver la actualización importada en la lista.

   

Obtenga más información sobre cómo importar actualizaciones.

Creación de un grupo de actualización

1. Vaya a la pestaña Grupos e implementaciones en la parte superior de la página.

   

2. Seleccione Agregar de grupo para crear un nuevo grupo.

   

3. Seleccione una etiqueta de IoT Hub y clase de dispositivo en la lista. A continuación, seleccione Crear grupo.

   

4. Una vez creado el grupo, se actualizan el gráfico de cumplimiento de actualizaciones y la lista de grupos. En el gráfico de Update Compliance se muestra el recuento de dispositivos en los distintos estados de compatibilidad: En la actualización más reciente, Nuevas actualizaciones disponibles y Actualizaciones en curso. Obtenga más información sobre Update Compliance.

   

5. Debería ver el grupo recién creado y las actualizaciones disponibles para los dispositivos del nuevo grupo. Si hay dispositivos que no cumplen los requisitos de clase de dispositivo del grupo, se mostrarán en un grupo no válido correspondiente. Para implementar la mejor actualización disponible en el nuevo grupo definido por el usuario desde esta vista, seleccione Implementar junto al grupo.

Obtenga más información sobre cómo agregar etiquetas y crear grupos de actualizaciones.

Implementación de la actualización

1. Una vez creado el grupo, debería ver una nueva actualización disponible para el grupo de dispositivos. Un vínculo a la actualización debe estar en Mejor actualización. Puede que tenga que actualizar la página una vez. Más información sobre el cumplimiento de actualizaciones.

2. Para elegir el grupo de destino, seleccione el nombre del grupo. Serás dirigido a Detalles del grupo en Conceptos básicos del grupo.

   

3. Para iniciar la implementación, vaya a la pestaña Implementación actual . Seleccione el vínculo Implementar situado junto a la actualización deseada en la sección Actualizaciones disponibles . La mejor actualización disponible para un grupo determinado se indica con el término Óptima resaltado.

   

4. Programe la implementación para que se inicie inmediatamente o en el futuro. Seleccione Crear.

   

5. En Detalles de implementación, Estado cambia a Activo. La actualización implementada está marcada con (implementando).

   

6. Vea el gráfico de cumplimiento para comprobar que la actualización está en curso.

7. Una vez que el dispositivo se ha actualizado correctamente, puede ver que el gráfico de cumplimiento y los detalles de la implementación se actualizan para reflejar lo mismo.

   

Supervisar la implementación de actualizaciones

1. Seleccione la pestaña Historial de implementación en la parte superior de la página.

   

2. Seleccione Detalles junto a la implementación que ha creado.

   

3. Seleccione Actualizar para ver los detalles de estado más recientes.

Ha completado con éxito una actualización de imagen de extremo a extremo usando Device Update para IoT Hub utilizando el agente de referencia del simulador Ubuntu (18.04 x64).

Limpieza de recursos

Cuando ya no sea necesario, limpie la cuenta de Device Update, la instancia, el centro de IoT y el dispositivo IoT.

Pasos siguientes