Implementación de una actualización mediante Device Update for Azure IoT Hub

Aprenda a implementar una actualización en un dispositivo IoT con Device Update para Azure IoT Hub.

Requisitos previos

• Acceda a una instancia de IoT Hub con Device Update for IoT Hub habilitado. Se recomienda usar un nivel S1 (estándar), o superior, para su instancia de IoT Hub.
• Una actualización importada del dispositivo aprovisionado.
• Un dispositivo IoT (o simulador) aprovisionado para Device Update en IoT Hub.
• El dispositivo forma parte de al menos un grupo predeterminado o un grupo de actualizaciones creado por el usuario.

Azure Portal

Exploradores admitidos:

• Microsoft Edge
• Google Chrome

CLI de Azure

Un entorno de la CLI de Azure:

• Use el entorno de Bash en Azure Cloud Shell.

  

• O bien, si prefiere ejecutar comandos de referencia de la CLI localmente, instale la CLI de Azure.

  1. Inicie sesión en la CLI de Azure mediante el comando az login.
  2. Ejecute az version para buscar cuál es la versión y las bibliotecas dependientes que están instaladas. Para realizar la actualización a la versión más reciente, ejecute az upgrade.
  3. Cuando se le solicite, instale las extensiones de la CLI de Azure la primera vez que lo use. Los comandos de este artículo usan la extensión azure-iot. Ejecute az extension update --name azure-iot para asegurarse de usar la versión más reciente de la extensión.

Sugerencia

Los comandos de la Interfaz de la línea de comandos de Azure citados en este artículo usan el carácter de la barra diagonal inversa \ para la continuación de línea y facilitar la lectura de los argumentos del comando. Esta sintaxis funciona en entornos Bash. Si ejecuta estos comandos en PowerShell, reemplace las barras diagonales inversas por acentos graves ``` o quítelas totalmente.

Implementación de la actualización

Azure Portal

1. En Azure Portal, navegue hasta su centro de IoT.

2. Seleccione Actualizaciones en el menú de navegación para abrir la página Device Update de la instancia de IoT Hub.

   

3. Seleccione la pestaña Groups and Deployments (Grupos e implementaciones) en la parte superior de la página. Para más información, consulte Grupos de dispositivos.

   

4. Consulte la lista de grupos y el gráfico de Update Compliance. Debería ver una nueva actualización disponible para el grupo predeterminado o basado en etiquetas. Puede que tenga que actualizar una vez. Para más información, consulte Cumplimiento de Device Update.

5. Seleccione Implementar junto a una o varias actualizaciones disponibles y confirme que la etiqueta descriptiva que agregó al importar está presente y tiene el aspecto correcto.

6. Confirme que se ha seleccionado el grupo correcto como grupo de destino y seleccione Implementar.

7. 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.

   

8. Programe la implementación para que se inicie inmediatamente o en el futuro.

   Sugerencia

   De forma predeterminada, la fecha y hora de Inicio se establece en Inmediatamente. Asegúrese de seleccionar una fecha y hora diferentes si quiere que la implementación comience más tarde.

   

9. Cree una directiva de reversión automática si es necesario. Seleccione Crear.

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

    

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

    

12. 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.

    

CLI de Azure

az iot du device group list para comprobar la mejor actualización disponible para el grupo. El comando toma los argumentos siguientes:

• --account: nombre de cuenta de Device Update.
• --instance: nombre de instancia de Device Update.
• --group-id: identificador del grupo de dispositivos al que se dirige esta implementación. Este identificador es el valor de la etiqueta ADUGroup o $default para los dispositivos sin etiqueta.
• --best-updates: esta marca indica que el comando debe capturar las mejores actualizaciones disponibles para el grupo de dispositivos, incluido un recuento de cuántos dispositivos necesitan cada actualización.
• "--resource-group -g": nombre del grupo de recursos de la cuenta de Device Update.
• "--update-compliance": esta marca indica que el comando debe capturar información de Update Compliance del grupo de dispositivos, como el número de dispositivos en su actualización más reciente, cuántos necesitan nuevas actualizaciones y cuántos están en curso al recibir una nueva actualización.

az iot du device group list \
    --account <Device Update account name> \
    --instance <Device Update instance name>\
    --gid <device group id>\
    --best-updates {false, true}

Use az iot du device deployment create para crear una implementación para un grupo de dispositivos.

El comando device deployment create toma los argumentos siguientes:

• --account: nombre de cuenta de Device Update.
• --instance: nombre de instancia de Device Update.
• --group-id: identificador del grupo de dispositivos al que se dirige esta implementación. Este identificador es el valor de la etiqueta ADUGroup o $default para los dispositivos sin etiqueta.
• --deployment-id: identificador para identificar esta implementación.
• --update-name, --update-provider y --update-version: estos tres parámetros definen el objeto updateId que es un identificador único para la actualización que está usando en esta implementación.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version>

Los argumentos opcionales le permiten configurar la implementación. Para obtener la lista completa, consulte Parámetros opcionales.

Si desea crear una directiva de reversión automática, agregue los parámetros siguientes:

• --failed-count: número de dispositivos con errores en una implementación que desencadenará una reversión.
• --failed-percentage: porcentaje de dispositivos con errores en una implementación que desencadenará una reversión.
• --rollback-update-name, --rollback-update-provider, --rollback-update-version: updateID de la actualización que usará el grupo de dispositivos si se inicia una reversión.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --failed-count 10 \
    --failed-percentage 5 \
    --rollback-update-name <rollback update name> \
    --rollback-update-provider <rollback update provider> \
    --rollback-update-version <rollback update version>

Si quiere que la implementación se inicie en el futuro, use el parámetro --start-time para proporcionar la fecha y hora de destino de la implementación.

az iot du device deployment create \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id> \
    --deployment-id <deployment id> \
    --update-name <update name> \
    --update-provider <update provider> \
    --update-version <update version> \
    --start-time "2022-12-20T01:00:00"

Supervisión de una implementación de actualizaciones

Azure Portal

1. Seleccione el grupo en el que implementó y vaya a la pestaña Actualizaciones actuales o Historial de implementación para confirmar que la implementación está en curso.

   

2. Seleccione Detalles junto a la implementación que ha creado. Aquí puede ver los detalles de la implementación, los detalles de actualización y los detalles de clase del dispositivo de destino. Opcionalmente, puede agregar un nombre descriptivo para la clase de dispositivo.

   

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

4. Puede ir a la vista de conceptos básicos del grupo para buscar el estado de un dispositivo determinado o filtrar para ver los dispositivos que han producido un error en la implementación.

CLI de Azure

Use az iot du device deployment list para ver toda la implementación de un grupo de dispositivos.

az iot du device deployment list \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group id>

Use az iot du device deployment show para ver los detalles de una implementación determinada.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID>

Agregue la marca --status para devolver información sobre cuántos dispositivos de la implementación están en curso, completados o con errores.

az iot du device deployment show \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --group-id <device group ID> \
    --deployment-id <deployment ID> \
    --status

Reintento de una implementación de actualizaciones

Si por algún motivo se produce un error en la implementación, puede volver a intentarla para los dispositivos en los que se han producido errores.

Azure Portal

1. Vaya a la pestaña Current deployment (Implementación actual) en la pantalla Group details (Detalles del grupo).

   

2. Seleccione Retry failed devices (Reintentar dispositivos con errores) y acepte la notificación de confirmación.

CLI de Azure

Use az iot du device deployment retry para reintentar una implementación para un subgrupo de dispositivos de destino.

Este comando toma el argumento --class-id, que se genera a partir del identificador de modelo y las propiedades de compatibilidad notificadas por el agente de Device Update.

az iot du device deployment retry \
    --account <Device Update account name> \
    --instance <Device Update instance name> \
    --deployment-id <deployment ID> \
    --group-id <device group ID> \
    --class-id <device class ID>

Pasos siguientes

Solución de problemas comunes