Migración de dispositivos y grupos a la versión más reciente de Device Update for IoT Hub

  • Artículo

Dado que el servicio Device Update for IoT Hub lanza versiones nuevas, es aconsejable actualizar los dispositivos para tener las últimas características y mejoras de seguridad. En este artículo se proporciona información sobre cómo migrar la [versión de la actualización de la versión preliminar pública (PPR)] a la versión GA actual. En este artículo también se explica el comportamiento del grupo y la experiencia de usuario en estas versiones. Si no tiene dispositivos, grupos e implementaciones que usen la versión preliminar pública actualizada, puede omitir esta página.

Para migrar correctamente, tendrá que actualizar el agente DU que se ejecuta en los dispositivos. Tenga en cuenta que, como hay cambios importantes con la versión GA, se recomienda seguir las instrucciones con atención para evitar errores.

Nota

Todos los grupos de dispositivos PPR creados se cambiarán automáticamente a grupos de disponibilidad general. Los grupos y dispositivos estarán disponibles después de la migración. El historial de implementación no se transferirá a los grupos de disponibilidad general actualizados.

Actualización del agente de Device Update

Para la versión de disponibilidad general, el agente de Device Update se puede actualizar manualmente o usar el servicio Device Update mediante actualizaciones de imágenes o manifiestos de apt. Si usa actualizaciones de imágenes, puede incluir el agente de Device Update de disponibilidad general en la actualización.

Actualización manual del agente DU

  1. Antes de actualizar el dispositivo, los atributos del dispositivo incluirán los detalles del modelo PnP de PPR. El nombre del modelo de contrato mostrará Device Update Model V1 y Contract Model ID (Id. de modelo de contrato) mostrará dtmi:azure:iot:deviceUpdateContractModel;1.

  2. Aplique SSH en el dispositivo y actualice el agente de Device Update.

    sudo apt install deviceupdate-agent
sudo systemctl restart deviceupdate-agent
sudo systemctl status deviceupdate-agent

  3. Confirme que el agente DU se está ejecutando correctamente. Busque "HealthCheck pasado"

    sudo -u adu /usr/bin/AducIotAgent -h

  4. Consulte el dispositivo actualizado en el portal de Device Update. Los atributos del dispositivo ahora mostrarán los detalles actualizados del modelo PnP. El nombre del modelo de contrato mostrará Device Update Model V2 y Contract Model ID (Id. de modelo de contrato ) mostrará dtmi:azure:iot:deviceUpdateContractModel;2.

Actualización del agente DU de OTA a través del manifiesto de APT

  1. Antes de actualizar los dispositivos, los atributos del dispositivo incluirán los detalles del modelo PnP de PPR. El nombre del modelo de contrato mostrará Device Update Model V1 y Contract Model ID (Id. de modelo de contrato) mostrará dtmi:azure:iot:deviceUpdateContractModel;1.

  2. Agregue la actualización del agente de Device Update como último paso de la actualización. La versión del manifiesto de importación debe ser "4.0" para garantizar que está destinada a los dispositivos correctos. Vea a continuación un manifiesto de importación de ejemplo y un manifiesto APT:

    Ejemplo de manifiesto de importación

    {
   "manifestVersion": "4",
   "updateId": {
     "provider": "Contoso",
     "name": "Sensor",
     "version": "1.0"
   },
   "compatibility": [
     {
       "manufacturer": "Contoso",
       "model": "Sensor"
     }
   ],
   "instructions": {
     "steps": [
       {
     "handler": "microsoft/apt:1",
     "handlerProperties": {
       "installedCriteria": "1.0"
     },
     "files": [
       "fileId0"
     ]
       }
     ]
   },
   "files": {
     "fileId0": {
       "filename": "sample-upgrade-apt-manifest.json",
       "sizeInBytes": 210,
       "hashes": {
     "sha256": "mcB5SexMU4JOOzqmlJqKbue9qMskWY3EI/iVjJxCtAs="
       }
     }
   },
   "createdDateTime": "2022-08-20T18:32:01.8404544Z"
 }

    Ejemplo de manifiesto APT

      {
    "name": "Sample DU agent upgrade update",
    "version": "1.0.0",
    "packages": [
    {
        "name": "deviceupdate-agent"
    }
    ]
}

Nota

Es necesario que la actualización del agente sea el último paso. Es posible que tenga que seguir otros pasos antes de la actualización del agente. Los pasos agregados después de la actualización del agente no se ejecutarán y no se notificarán correctamente, ya que el dispositivo se vuelve a conectar con el servicio DU.

  1. Implementación de la actualización.

  2. En cuanto la actualización se implemente correctamente, los atributos del dispositivo ahora mostrarán los detalles actualizados del modelo PnP. El nombre del modelo de contrato mostrará Device Update Model V2 y Contract Model ID (Id. de modelo de contrato ) mostrará dtmi:azure:iot:deviceUpdateContractModel;2.

Comportamiento de grupo e implementación entre versiones

  • El dispositivo con el agente DU de actualización de versión preliminar pública ( 0.8.x) y el agente du de disponibilidad general (1.0.x) se pueden administrar a través del portal de Device Update.

  • Los dispositivos con agentes anteriores (0.7.0/0.6.0) no se pueden agregar a estos grupos.

Pasos siguientes

Descripción del archivo de configuración del agente de Device Update

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