Implementar una actualización mediante Azure Device Update for IoT Hub

En este artículo, aprenderá a implementar una actualización en dispositivos IoT mediante Azure Device Update for IoT Hub en Azure Portal o con la CLI de Azure.

Requisitos previos

• Una instancia estándar (S1) o superior de Azure IoT Hub con Device Update for IoT Hub habilitado.
• Un dispositivo o simulador de IoT Aprovisionado para Device Update dentro del centro de IoT. El dispositivo aprovisionado puede ser miembro de un grupo de dispositivos creado por el usuario o el grupo predeterminado.
• Una actualización importada del dispositivo aprovisionado.

Implementación de la actualización

En esta sección se describe cómo implementar la actualización mediante Azure Portal o la CLI de Azure.

Azure Portal

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

2. Seleccione Actualizaciones en Administración de dispositivos en el panel de navegación izquierdo.

   

3. En la página Actualizaciones, seleccione la pestaña Grupos e implementaciones y vea el gráfico de cumplimiento de actualizaciones y lista de grupos de dispositivos. Es posible que tenga que actualizar la vista para ver las actualizaciones importadas recientemente disponibles para el grupo de dispositivos.

4. En Estado de la lista de grupos, seleccione Implementar junto a Una o varias actualizaciones nuevas están disponibles para este grupo.

   

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

6. Seleccione Implementar junto al estado una o varias actualizaciones disponibles.

7. En la lista de la derecha, seleccione la actualización deseada que se va a implementar.

   

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

   Sugerencia

   De forma predeterminada, la fecha y hora de inicio es de 24 horas a partir de la hora actual. Asegúrese de seleccionar una fecha y hora diferentes si desea que la implementación comience antes o más tarde.

   

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

10. En la pestaña Actualizaciones actuales, puede ver el estado de la implementación.

    

11. En la vista Aspectos básicos del grupo, el gráfico de cumplimiento muestra que la actualización está en curso.

    Después de que el dispositivo se actualice correctamente, el gráfico de cumplimiento y los detalles de implementación se actualizan para reflejar ese estado.

CLI de Azure

Puede usar el entorno de Bash en Azure Cloud Shell para ejecutar los comandos siguientes. Seleccione Iniciar Cloud Shell para abrir Cloud Shell o seleccione el icono de Cloud Shell en la barra de herramientas superior de Azure Portal.

O, si lo prefiere, puede ejecutar los comandos de la CLI de Azure localmente:

1. Instalación de la CLI de Azure. Ejecute az version para ver la versión instalada de la CLI de Azure y las bibliotecas dependientes, y ejecute az upgrade para instalar la versión más reciente.
2. Ejecute az login para iniciar sesión en Azure.
3. Instale la extensión azure-iot cuando se le solicite por primera vez. Para asegurarse de que usa la versión más reciente de la extensión, ejecute az extension update --name azure-iot.

Sugerencia

Los comandos de la CLI de Azure de este artículo usan el carácter de barra diagonal inversa \ para la continuación de línea para que los argumentos del comando sean más fáciles de leer. Esta sintaxis funciona en entornos Bash. Si ejecuta estos comandos en PowerShell, reemplace cada barra diagonal inversa por una barra diagonal inversa "o quítelas por completo.

Comprobación de la disponibilidad de actualizaciones

1. Use el comando az iot du device group list para identificar el grupo de dispositivos.

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

2. A continuación, use az iot du device group show para mostrar 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: el identificador de grupo de dispositivos al que está destinado esta implementación, que es el valor de la etiqueta ADUGroup o $default para dispositivos sin etiqueta.
   • --resource-group: el nombre del grupo de recursos de la cuenta de Device Update.
   • --best-updates: devuelve las mejores actualizaciones disponibles para el grupo de dispositivos, incluido un recuento de cuántos dispositivos necesitan cada actualización.
   • --update-compliance: devuelve la información de cumplimiento de actualizaciones del grupo de dispositivos, como el número de dispositivos en su actualización más reciente, cuántas necesitan actualizaciones nuevas y cuántas reciben actualmente una nueva actualización.

   Para comprobar la mejor actualización disponible para el grupo, ejecute el comando de la siguiente manera:

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

Creación de la implementación

Use az iot du device deployment create para crear una implementación para el grupo de dispositivos. El comando toma los argumentos siguientes:

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

Ejecute el comando de la siguiente manera:

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>

Uso de argumentos opcionales

Los argumentos opcionales permiten configurar aún más la implementación. Para obtener la lista completa de argumentos opcionales, vea Parámetros opcionales.

Para 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 desencadena una reversión.
• --failed-percentage: el porcentaje de dispositivos con errores en una implementación que desencadena una reversión.
• --rollback-update-name, --rollback-update-provider, --rollback-update-version: los parámetros de la actualización que se van a usar si se inicia una reversión.

Ejecute el comando de la siguiente manera:

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>

Para establecer la hora de inicio de la implementación, use el parámetro --start-time para proporcionar la fecha y hora de destino de la implementación, como se indica a continuació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 del estado de implementación

Azure Portal

1. En la pestaña Grupos e implementaciones de la página Actualizaciones, seleccione el grupo en el que se implementó.

2. En la página Detalles del grupo, vaya a la pestaña Implementación actual o Historial de implementación para confirmar que una implementación está en curso.

   

3. Seleccione Detalles junto a una implementación para ver los detalles de implementación, los detalles de actualización y los detalles de la clase de dispositivo de destino. Opcionalmente, puede agregar un nombre descriptivo para la clase de dispositivo.

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

   

Vaya a la pestaña Aspectos básicos del grupo de la página de Detalles del grupo para buscar el estado de un dispositivo determinado o filtrar para ver los dispositivos con errores en la implementación.

CLI de Azure

Use az iot du device deployment list para ver todas las implementaciones 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 se produce un error en la implementación, puede volver a intentar la implementación de los dispositivos con 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>

Contenido relacionado

• Implementaciones de Device Update
• Guía de solución de problemas de Device Update