Importación de una actualización a Device Update for IoT Hub

Obtenga información sobre cómo obtener una nueva actualización e importarla en Device Update for IoT Hub. Si aún no lo ha hecho, asegúrese de revisar los conceptos de importación de claves y cómo preparar una actualización para importarla.

Prerrequisitos

• Acceso a una instancia de IoT Hub con Device Update for IoT Hub habilitado.

• Un contenedor de Azure Storage sin punto de conexión privado habilitado.

  • Si no está seguro de si el punto de conexión privado está habilitado, vaya a Private Link Center, seleccione "Puntos de conexión privados" a la izquierda y busque el nombre de la cuenta de Azure Storage en la columna "Recursos".

• Un dispositivo IoT (o simulador) aprovisionado para Device Update en IoT Hub.

• Siga los pasos descritos en Preparación de una actualización para importarla a Device Update for IoT Hub para crear el manifiesto de importación para los archivos de actualización.

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 cada barra diagonal inversa por un acento grave (```) o quítelas por completo.

Importación de una actualización

En esta sección se muestra cómo importar una actualización mediante Azure Portal o la CLI de Azure. En su lugar, también puede usar las API de Device Update for IoT Hub para importar una actualización.

Para importar una actualización, primero debe cargar los archivos de actualización e importar el manifiesto en un contenedor de Azure Storage. A continuación, importe la actualización de Azure Storage a Device Update for IoT Hub, donde se almacenará para que pueda realizar la implementación en los dispositivos.

Azure Portal

1. En Azure Portal y vaya a su instancia de IoT Hub con Device Update.

2. En el lado izquierdo de la página, seleccione Actualizaciones en Administración de dispositivos.

   

3. Seleccione la pestaña Actualizaciones en la lista de pestañas de la parte superior de la pantalla.

   

4. Seleccione + Importar una nueva actualización debajo del encabezado Novedades disponibles.

   

5. Elija + Seleccionar uno del contenedor de almacenamiento. Se muestra la interfaz de usuario Cuentas de almacenamiento. Seleccione una cuenta existente o cree una cuenta con + Cuenta de almacenamiento. Esta cuenta se usa para que un contenedor almacene provisionalmente las actualizaciones para su importación. La cuenta no debe tener habilitados los puntos de conexión públicos y privados al mismo tiempo.

   

6. Una vez que haya seleccionado una cuenta de almacenamiento, se muestra la interfaz de usuario Contenedores. Seleccione un contenedor existente o cree uno nuevo mediante + Contenedor. Este contenedor se usa para almacenar provisionalmente los archivos de actualización para la importación

   Se recomienda usar un nuevo contenedor cada vez que importe una actualización. El usar siempre nuevos contenedores le ayuda a evitar la importación accidental de archivos de las actualizaciones anteriores. Si no usa un contenedor nuevo, asegúrese de eliminar los archivos del contenedor existente antes de finalizar este paso.

   

7. En el contenedor, seleccione Cargar. Se muestra interfaz de usuario Cargar.

   

8. Seleccione el icono de carpeta en el lado derecho de la sección Archivos bajo el encabezado Cargar blob. Use el selector de archivos para ir a la ubicación de los archivos de actualización e importar el manifiesto, seleccione todos los archivos y seleccione Abrir. Puede mantener presionada la tecla Mayús y hacer clic en archivos de selección múltiple.

   

9. Cuando haya seleccionado todos los archivos de la actualización, seleccione Cargar.

   

10. Seleccione los archivos cargados para designarlos para la importación. A continuación, seleccione el botón Seleccionar para volver a la página Importar actualización.

    

11. En la página Import update (Importar actualización), revise los archivos que se importarán. A continuación, seleccione Importar actualización para iniciar el proceso de importación. Para resolver los errores, consulte Solución de problemas de actualización de proxy.

    

12. Se inicia el proceso de importación y la pantalla cambia a la sección Historial de importación. Seleccione Actualizar para ver el progreso hasta que finalice el proceso de importación (en función del tamaño de la actualización, esta operación puede tardar unos minutos, pero podría prolongarse más).

    

13. Cuando la columna Estado indique que la importación se ha realizado correctamente, seleccione el encabezado Actualizaciones disponibles. Debería ver la actualización importada en la lista.

    

CLI de Azure

El comando az iot du update stage controla los pasos previos para importar una actualización, incluida la carga de los archivos de actualización en un contenedor de almacenamiento de destino. Una marca opcional también permite que este comando importe automáticamente los archivos una vez preparados. De lo contrario, el comando az iot du update import completa el proceso.

El comando stage toma los argumentos siguientes:

• --account: nombre de cuenta de Device Update.
• --instance: nombre de instancia de Device Update.
• --manifest-path: ruta de acceso del archivo al manifiesto de importación que se debe almacenar provisionalmente.
• --storage-account: el nombre de la cuenta de almacenamiento para almacenar provisionalmente la actualización.
• --storage-container: el nombre del contenedor dentro de la cuenta de almacenamiento seleccionada para almacenar provisionalmente la actualización.
• --overwrite: marca opcional que indica si se van a sobrescribir los blobs existentes en el contenedor de almacenamiento si hay un conflicto.
• --then-import: marca opcional que indica si la actualización se debe importar a Device Update después de realizar el almacenamiento provisional.

az iot du update stage \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    --manifest-path <Replace with the full path to your import manifest> \
    --storage-account <Replace with your Storage account name> \
    --storage-container <Replace with your container name> \
    --overwrite --then-import

Por ejemplo:

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/file.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

Si tiene varios manifiestos de importación, puede incluirlos todos en un solo comando. Por ejemplo:

az iot du update stage \
    --account deviceUpdate001 \
    --instance myInstance \
    --manifest-path /my/apt/manifest/parent.importmanifest.json \
    --manifest-path /my/apt/manifest/child1.importmanifest.json \
    --manifest-path /my/apt/manifest/child2.importmanifest.json \
    --storage-account deviceUpdateStorage \
    --storage-container deviceUpdateDemo \
    --overwrite --then-import

Si no usa la marca --then-import, la salida del comando stage incluye una solicitud para ejecutar az iot du update import, incluidos los argumentos rellenados previamente.

Use az iot du update list para comprobar que la actualización o las actualizaciones se han importado correctamente.

az iot du update list \
    --account <Replace with your Device Update account name> \
    --instance <Replace with your Device Update instance name> \
    -o table

Si va a importar mediante API en su lugar

También puede importar una actualización mediante programación de las siguientes formas:

• Uso de Azure SDK para .NET, Java, JavaScript o Python
• Uso de la API de REST de actualización de importación
• Uso de módulos de PowerShell de ejemplo
  • Requiere PowerShell 5 o posterior (incluye las instalaciones de Linux, macOS y Windows)

Nota

Consulte Roles de usuario de actualización de dispositivos y acceso para obtener el permiso de API necesario.

Los archivos de actualización y el manifiesto de importación deben cargarse en un contenedor de Azure Storage Blob para el almacenamiento provisional. Para importar los archivos almacenados provisionalmente, proporcione la dirección URL del blob o la Firma de acceso compartido (SAS) para blobs privados a una API de actualización de dispositivos. Si usa una SAS, asegúrese de proporcionar un período de expiración de tres horas o más

Sugerencia

Para cargar archivos de actualización grandes en contenedores de Azure Storage Blob, puede usar una de las siguientes opciones para mejorar el rendimiento:

• AzCopy
• Explorador de Azure Storage

Pasos siguientes

• Creación de grupos
• Información sobre los conceptos de la importación