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

1. Vaya a su hub de IoT en el portal Azure.

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. Para la seguridad en las descargas, selecciona HTTPS (recomendado) o HTTP. Esta configuración controla el protocolo que los dispositivos utilizan para descargar el contenido de la actualización. HTTPS es el predeterminado y cifra el contenido de las actualizaciones en tránsito.

   Para orientación sobre cómo elegir un protocolo y preparar tus dispositivos, consulta Entender la seguridad de descargas (TLS) en Actualización de dispositivos para IoT Hub.

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

   

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

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

    

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

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.

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>

Los dispositivos descargan el contenido actualizado por HTTPS por defecto. Para usar HTTP en su lugar, añade el parámetro opcional --download-security descrito en Usar argumentos opcionales.

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"

Para elegir el protocolo que usan los dispositivos para descargar el contenido de la actualización, añade el parámetro opcional --download-security . Los valores aceptados son HTTPS (recomendado) y HTTP. Si omites el parámetro, el despliegue usa el valor por defecto HTTPS. Para orientación sobre cómo elegir un protocolo y preparar tus dispositivos, consulta Entender la seguridad de descargas (TLS) en Actualización de dispositivos para IoT Hub.

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> \
    --download-security <HTTPS or HTTP>

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.

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

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.

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

Este comando toma el --class-id argumento, que se genera a partir del ID del modelo y las propiedades de compatibilidad reportadas por el agente de actualización del dispositivo:

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>