Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Antes de poder desplegar una actualización de software en un grupo de dispositivos o en dispositivos que se integran en un espacio de nombres, necesitas importar la actualización en tu espacio de nombres del Registro de Dispositivos de Azure. Cada actualización de software consta de uno o más archivos de actualización y un manifiesto de importación. El manifiesto de importación describe la identidad de la actualización, los dispositivos con los que es compatible y cómo instalarla, para que el Registro de Dispositivos de Azure sepa a qué dispositivos se aplica la actualización.
Este artículo te muestra cómo importar una actualización de software desde un contenedor de Azure Storage a un espacio de nombres, y cómo eliminar una actualización importada que ya no necesitas.
Importante
Las actualizaciones de software de Azure Device Registry se encuentran actualmente en versión preliminar. La vista previa actual está dirigida a dispositivos conectados al IoT Hub. Esta versión preliminar se ofrece sin un acuerdo de nivel de servicio, y es posible que la funcionalidad y la experiencia en el portal cambien antes de que esté disponible de forma generalizada. Para obtener más información, vea Términos de uso complementarios para las versiones preliminares de Microsoft Azure.
Prerequisites
- Una suscripción de Azure activa. Si no tiene una, cree una cuenta gratuita.
- Un espacio de nombres en el Registro de Dispositivos de Azure con actualizaciones de software habilitadas. Para crear un espacio de nombres y habilitar actualizaciones de software, consulte Empezar con Azure Device Registry para Azure IoT Hub.
- Permisos para leer los archivos de actualización en tu cuenta de almacenamiento, como el rol Storage Blob Data Contributor.
- Permisos para importar actualizaciones de software al espacio de nombres, como el rol de Administrador de Contenido de Actualización de Dispositivos en la instancia de actualizaciones de software vinculada a tu espacio de nombres.
- Una cuenta de Azure Storage con un contenedor que guarda tus archivos de actualización y un manifiesto de importación:
-
Archivos de actualización: Los archivos que instala tu dispositivo, como una imagen, un paquete o un script (por ejemplo,
.swuo.sh). -
Manifiesto de importación: Un archivo JSON con la extensión
.importmanifest.jsonque describe la actualización. Cada actualización de software requiere un manifiesto de importación. Para aprender a crear uno, consulta Preparar una actualización para importar y el esquema del manifiesto de importación.
-
Archivos de actualización: Los archivos que instala tu dispositivo, como una imagen, un paquete o un script (por ejemplo,
Ve a actualizaciones de software en tu espacio de nombres
- En el portal de Azure, ve a tu espacio de nombres del Registro de Dispositivos de Azure.
- En el menú de recursos, bajo Operaciones, selecciona actualizaciones de software (vista previa).
- En la página de Actualizaciones de software (vista previa), seleccione la pestaña Importaciones para ver las actualizaciones de software que ya se han importado al espacio de nombres.
Si aún no has importado ninguna actualización, la página muestra No hay actualizaciones para mostrar.
Importar una actualización de software
En Actualizaciones de software (vista previa), selecciona + Importar.
En Importar actualizaciones de software, en Selección de archivos, seleccione + Añadir archivos.
Selecciona la cuenta de almacenamiento que contiene tus archivos de actualización y luego selecciona Siguiente.
Selecciona el contenedor que contiene tus archivos de actualización y luego selecciona Siguiente.
En Select archivos, selecciona los archivos de actualización y el archivo de importación de manifiestos (con la
.importmanifest.jsonextensión) que quieres importar.Cierra el selector de archivos para volver a Importar actualizaciones de software.
En el cuadro de Descripción , opcionalmente introduce una descripción para la actualización.
En Escanear malware, selecciona Escanear archivos de actualización para malware si quieres que los archivos de actualización se comprueben para detectar malware conocido antes de importarlos. El escaneo de malware está disponible en regiones seleccionadas.
Seleccione Importar.
Cuando la importación tiene éxito, la actualización aparece en la lista de Importaciones con su nombre, proveedor, versión y descripción. Ahora puedes desplegarlo usando un trabajo de actualización de software o un trabajo de actualización de incorporación.
Arreglar un manifiesto de importación que falta
Si seleccionas Actualizar archivos sin un manifiesto de importación, la importación falla con el mensaje No se encontró ningún manifiesto de importación.
- Revisa el banner de error en la página de Importar actualizaciones de software . Te recuerda que los archivos de manifiesto de importación usan la extensión
.importmanifest.json. - Añade un manifiesto de importación que describa la actualización de tu contenedor de almacenamiento.
- Selecciona Reemplazar archivos, luego selecciona tus archivos de actualización y el manifiesto de importación.
- Selecciona Importar de nuevo.
Note
En esta vista previa, no puedes crear ni editar un manifiesto de importación en el portal de Azure. Crea el manifiesto de importación antes de importar la actualización.
Importar actualizaciones principales y secundarias
Un manifiesto de importación puede referenciar otras actualizaciones. Por ejemplo, una actualización padre puede hacer referencia a una o más actualizaciones hijas que deben instalarse juntas o en un orden específico. Cuando importas una actualización principal junto con sus actualizaciones secundarias, la lista Importaciones muestra la actualización principal con sus actualizaciones secundarias asociadas.
Note
En esta vista previa, el cliente de actualizaciones de software en los SDKs unificados de Azure IoT no instala actualizaciones que hagan referencia a otras actualizaciones. Para desplegar en dispositivos que usen el cliente de actualizaciones de software, importa actualizaciones cuyos manifiestos de importación no hagan referencia a actualizaciones secundarias. Para más información, consulte Limitaciones de la vista previa.
Eliminar una actualización de software
Si ya no necesitas una actualización importada, puedes eliminarla del espacio de nombres.
- En la página de Actualizaciones de software (vista previa), selecciona la pestaña Imports.
- Selecciona la casilla de verificación junto a la actualización que quieres eliminar.
- Seleccione Eliminar.
- Cuando se le solicite, seleccione Eliminar para confirmar.
Eliminar una actualización de software no afecta a los dispositivos que ya la instalaron. Sin embargo, ya no puedes usar la actualización en un nuevo trabajo.