Aprovisionamiento del agente de actualización de dispositivos

El agente del módulo Device Update se puede ejecutar junto con otros procesos del sistema y módulos de IoT Edge que se conectan a IoT Hub como parte del mismo dispositivo lógico. En esta sección se describe cómo aprovisionar el agente de Device Update como una identidad de módulo.

Cambios en el agente de Device Update en la actualización de versión preliminar pública

Hemos agregado muchas funcionalidades nuevas al agente de Device Update en el agente de actualización de versión preliminar pública más reciente (versión 0.8.0). Consulte lista de nuevas funcionalidades para obtener más información.

Si usa las versiones del agente de Device Update 0.6.0 o 0.7.0, migre a la versión más reciente del agente 0.8.0. Consulte agente de actualización de versión preliminar pública para ver los cambios y cómo actualizar

Puede comprobar la versión instalada del agente de Device Update y el agente de optimización de distribución en la sección Propiedades del dispositivo de dispositivo IoT gemelo. Obtenga más información sobre las propiedades del dispositivo en ADU Core Interface.

Identidad del módulo frente a identidad de dispositivo

En IoT Hub, en cada identidad de dispositivo, puede crear hasta 50 identidades de módulos. Cada identidad de módulo genera implícitamente un módulo gemelo. Desde el lado del dispositivo, los SDK de dispositivo de IoT Hub le capacitan para crear módulos, donde cada uno abre una conexión independiente a IoT Hub. La identidad del módulo y el módulo gemelo proporcionan las funcionalidades similares a la identidad del dispositivo y al dispositivo gemelo, pero con una granularidad más fina. Más información sobre las identidades de módulo en IoT Hub

Si va a migrar desde un agente a nivel de dispositivo para agregar el agente como una identidad de módulo en el dispositivo, quite el agente anterior que se estaba comunicando a través del Device Twin. Al aprovisionar el agente de Device Update como identidad de módulo, todas las comunicaciones entre el dispositivo y el servicio Device Update se producen a través del módulo gemelo, por lo que recuerde etiquetar el módulo gemelo del dispositivo al crear grupos de y todas las comunicaciones de deben ocurrir a través del módulo gemelo.

Compatibilidad con Device Update

Actualmente se admiten los siguientes tipos de actualización de IoT a través del aire con Device Update:

Prerrequisitos

Si está configurando el dispositivo IoT o el dispositivo IoT Edge para actualizaciones basadas en paquetes , añada packages.microsoft.com a los repositorios de la máquina siguiendo estos pasos:

  1. Inicie sesión en la máquina o en el dispositivo IoT en el que desea instalar el agente de Device Update.

  2. Abra una ventana terminal.

  3. Instale la configuración del repositorio que coincida con el sistema operativo del dispositivo.

    curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list

  4. Copie la lista generada en el directorio sources.list.d.

    sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/

  5. Instale la clave pública de GPG de Microsoft.

    curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg

    sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/

Cómo aprovisionar el agente de actualización de dispositivos como identidad de módulo

En esta sección se describe cómo aprovisionar el agente de Device Update como una identidad de módulo en

  • Dispositivos habilitados para IoT Edge o
  • Dispositivos IoT no perimetrales, o
  • Otros dispositivos IoT.

Para comprobar si tiene IoT Edge habilitado en el dispositivo, consulte las instrucciones de instalación de IoT Edge.

Siga todas las secciones siguientes o cualquiera de las secciones siguientes para agregar el agente de actualización de dispositivos en función del tipo de dispositivo IoT que administra.

En dispositivos habilitados para IoT Edge

Siga estas instrucciones para aprovisionar el agente de Device Update en dispositivos habilitados para IoT Edge.

  1. Siga las instrucciones para aprovisionar manualmente un único dispositivo IoT Edge de Linux.

  2. Instale el agente de actualización de imágenes de Device Update.

    Se proporcionan imágenes de ejemplo en el repositorio Assets. El archivo swUpdate es la imagen base que puede flashear en una placa Raspberry Pi B3+. El archivo .gz es la actualización que importaría a través de Device Update para IoT Hub. Para obtener un ejemplo, consulte Cómo flashear la imagen en el dispositivo IoT Hub.

  3. Instale el agente de actualización de paquetes de Device Update.

    • Para las versiones más recientes del agente de packages.miscrosoft.com: actualice las listas de paquetes en el dispositivo e instale el paquete del agente de Device Update y sus dependencias mediante:

      sudo apt-get update

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

    • Para cualquier "rc", es decir, versiones candidatas para el lanzamiento del agente de Artifacts : descargue el archivo .deb en la máquina en la que desea instalar el agente de Device Update y luego:

      sudo apt-get install -y ./"<PATH TO FILE>"/"<.DEB FILE NAME>"

  4. Ya está listo para iniciar el agente de Device Update en el dispositivo IoT Edge.

En dispositivos IoT Linux sin IoT Edge instalado

Siga estas instrucciones para aprovisionar el agente de Device Update en los dispositivos IoT Linux.

  1. Instale IoT Identity Service y agregue la versión más reciente al dispositivo IoT siguiendo las instrucciones de Instalación de Azure IoT Identity Service.

  2. Configure el Servicio de Identidad IoT siguiendo las instrucciones de la Configuración del Servicio de Identidad IoT de Azure.

  3. Por último, instale el agente de Device Update. Proporcionamos imágenes de ejemplo en Activos aquí, el archivo swUpdate es la imagen base que puede flashear en una placa Raspberry Pi B3+ y el archivo .gz es la actualización que se importaría a través de Device Update para IoT Hub. Consulte el ejemplo de cómo flashear la imagen en el dispositivo IoT Hub.

  4. Después de instalar el agente de device update, deberá editar el archivo de configuración de Device Update ejecutando el comando siguiente.

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

    Cambie el connectionType a "AIS" para los agentes que usarán el Servicio de Identidad de IoT para el aprovisionamiento. El campo ConnectionData debe ser una cadena vacía.

  5. Ya está listo para iniciar el agente de Device Update en el dispositivo IoT.

Otros dispositivos IoT

El agente de Device Update también se puede configurar sin el servicio de identidad de IoT para pruebas o en dispositivos con restricciones. Siga los pasos siguientes para aprovisionar el agente de Device Update mediante una cadena de conexión (desde el módulo o el dispositivo).

  1. Se proporcionan imágenes de ejemplo en el repositorio Assets. El archivo swUpdate es la imagen base que puede flashear en una placa Raspberry Pi B3+. El archivo .gz es la actualización que importaría a través de Device Update para IoT Hub. Para obtener un ejemplo, consulte Cómo flashear la imagen en el dispositivo IoT Hub.

  2. Inicie sesión en la máquina o en el dispositivo IoT Edge o dispositivo IoT.

  3. Abra una ventana de terminal.

  4. Agregue la cadena de conexión al archivo de configuración de Device Update:

    1. Escriba lo siguiente en la ventana del terminal:

    2. Copia de la cadena de conexión principal

      • Si el agente de Device Update está configurado como módulo, copie la cadena de conexión principal del módulo.
      • De lo contrario, copie la cadena de conexión principal del dispositivo.

    3. Introduzca la cadena de conexión principal copiada en el valor del campo "connectionData" en el archivo du-config.json. Luego, guarde y cierre el archivo.

  5. Ahora ya está listo para iniciar el agente de Device Update en el dispositivo IoT.

Cómo iniciar el agente de Device Update

En esta sección se describe cómo iniciar y comprobar el agente de Device Update como una identidad de módulo que se ejecuta correctamente en el dispositivo IoT.

  1. Inicie sesión en el equipo o dispositivo que tenga instalado el agente de Device Update.

  2. Abra una ventana terminal y escriba el comando siguiente.

    sudo systemctl restart adu-agent

  3. Puede comprobar el estado del agente mediante el comando siguiente. Si ve algún problema, consulte esta guía de solución de problemas .

    sudo systemctl status adu-agent

    Debería ver el estado OK.

  4. En el portal de IoT Hub, vaya a dispositivos IoT o dispositivos IoT Edge para encontrar el dispositivo que configuró con el agente de actualización de dispositivos. Allí verá que el agente de Device Update se ejecuta como un módulo. Por ejemplo:

    Diagrama del nombre del módulo Device Update.

Compilación y ejecución del agente de Device Update

También puede crear y modificar su propio agente de actualización de dispositivos de cliente.

Siga las instrucciones para compilar el agente de actualización de dispositivos desde el origen.

Una vez que el agente se compila correctamente, es el momento de ejecutar el agente.

Ahora, realice los cambios necesarios para incorporar el agente a la imagen. Consulte cómo modificar el Agente de Actualización de Dispositivos para obtener orientación.

Guía de solución de problemas

Si tiene problemas, revise la Guía de solución de problemas de Device Update para IoT Hub para ayudar a desbloquear los posibles problemas y recopilar información necesaria para proporcionar a Microsoft.

Pasos siguientes

Puede usar los siguientes tutoriales para obtener una demostración sencilla de Device Update para IoT Hub:

  • Last updated on