Actualización de IoT Edge

Se aplica a: IoT Edge 1.5 IoT Edge 1.4

Importante

IoT Edge 1.5 LTS e IoT Edge 1.4 LTS son versiones compatibles. IoT Edge 1.4 LTS finaliza el ciclo de vida el 12 de noviembre de 2024.

Dado que el servicio de IoT Edge lanza versiones nuevas, actualice los dispositivos de IoT Edge para tener las últimas características y mejoras de seguridad. En este artículo se proporciona información sobre cómo actualizar los dispositivos IoT Edge cuando hay una versión nueva disponible.

Es necesario actualizar dos componentes lógicos de un dispositivo IoT Edge si quiere pasar a una versión más reciente.

• Subsistema de seguridad: se ejecuta en el dispositivo, controla las tareas basadas en seguridad e inicia los módulos cuando se inicia el dispositivo. El subsistema de seguridad solo se puede actualizar desde el propio dispositivo.

• Entorno de ejecución de IoT Edge: el entorno de ejecución de IoT Edge se compone de los módulos del centro de IoT Edge (edgeHub) y del agente de IoT Edge (edgeAgent). En función de cómo se estructure la implementación, el tiempo de ejecución puede actualizarse desde el dispositivo o de forma remota.

Cómo actualizar

Use las secciones de este artículo para actualizar tanto el subsistema de seguridad como los contenedores en tiempo de ejecución en un dispositivo.

Versiones de revisión

Al actualizar entre versiones de revisión, por ejemplo de la 1.4.1 a la 1.4.2, el orden de actualización no es importante. Puede actualizar el subsistema de seguridad o los contenedores en tiempo de ejecución antes o después del otro. Para actualizar entre versiones de revisión:

1. Actualización del subsistema de seguridad
2. Actualización de los contenedores del entorno de ejecución
3. Comprobar que las versiones coincidan

Puede solucionar problemas del proceso de actualización en cualquier momento.

Versiones principales o secundarias

Al actualizar entre versiones principales o secundarias, por ejemplo, de 1.4 a 1.5, actualice tanto el subsistema de seguridad como los contenedores en tiempo de ejecución. Antes de una versión, se prueba el subsistema de seguridad y la combinación de versión del contenedor en tiempo de ejecución. Para actualizar entre las versiones principales o secundarias del producto:

1. En el dispositivo, detenga IoT Edge mediante el comando sudo systemctl stop iotedge y desinstalar.

2. En el dispositivo, actualice el motor de contenedor, ya sea Docker o Moby.

3. En el dispositivo, instale IoT Edge.

   Si estás importando una configuración antigua mediante iotedge config import, entonces modifica la imagen [agent.config] del archivo /etc/aziot/config.toml generado para usar la imagen 1.4 para edgeAgent.

   Para obtener más información, consulte Configuración de la configuración del dispositivo IoT Edge.

4. En IoT Hub, actualice la implementación del módulo para hacer referencia a los módulos del sistema más recientes.

5. En el dispositivo, inicie IoT Edge mediante sudo iotedge config apply.

Puede solucionar problemas del proceso de actualización en cualquier momento.

Actualización del subsistema de seguridad

El subsistema de seguridad de IoT Edge incluye un conjunto de componentes nativos que deben actualizarse mediante el administrador de paquetes en el dispositivo IoT Edge.

Compruebe la versión del subsistema de seguridad que se ejecuta en el dispositivo mediante el comando iotedge version. Si usa IoT Edge para Linux en Windows, debe conectarse mediante SSH a la máquina virtual Linux para comprobar la versión.

Ubuntu/Debian

En dispositivos Linux x64, use apt-get o el administrador de paquetes adecuado para actualizar el subsistema de seguridad a la versión más reciente.

Actualice apt:

sudo apt-get update

Nota:

Para obtener instrucciones para obtener la configuración del repositorio más reciente de Microsoft, vea los pasos preliminares para la Instalación de IoT Edge.

Compruebe qué versiones de IoT Edge están disponibles:

apt list -a aziot-edge

Actualización de IoT Edge:

sudo apt-get install aziot-edge defender-iot-micro-agent-edge

La ejecución de apt-get install aziot-edge actualiza el subsistema de seguridad e instala el servicio de identidad, aziot-identity-service, como una dependencia necesaria.

Se recomienda instalar el microagente con el agente de Edge para habilitar la supervisión de seguridad y la protección de los dispositivos de Edge. Para obtener más información sobre Microsoft Defender para IoT, consulte ¿Qué es Microsoft Defender para IoT para generadores de dispositivos?.

Red Hat Enterprise Linux

Compruebe qué versiones de IoT Edge están disponibles.

yum list aziot-edge

Si quiere actualizar a la versión más reciente de IoT Edge, use el siguiente comando, que también actualiza el servicio de identidad a la versión más reciente:

sudo yum install aziot-edge

Linux en Windows

Para obtener información sobre IoT Edge para Linux en las actualizaciones de Windows, consulte Actualizaciones de EFLOW.

Windows

Nota:

Actualmente, no hay compatibilidad con IoT Edge que se ejecuta en dispositivos Windows en contenedores de Windows. Use un contenedor de Linux para ejecutar IoT Edge en Windows.

A continuación, vuelva a aplicar la configuración para asegurarse de que el sistema está totalmente actualizado.

sudo iotedge config apply

Actualización de los contenedores del entorno de ejecución

La forma en que actualiza el agente de IoT Edge y los contenedores del centro de IoT Edge depende de si usa etiquetas graduales (como 1.5) o etiquetas específicas (como 1.5.1) en la implementación.

Compruebe la versión de los módulos Agente de IoT Edge y Centro de IoT Edge instalada actualmente en el dispositivo mediante los comandos iotedge logs edgeAgent o iotedge logs edgeHub. Si usa IoT Edge para Linux en Windows, debe conectarse mediante SSH a la máquina virtual Linux para comprobar las versiones del módulo de runtime.

Información sobre las etiquetas de IoT Edge

Las imágenes del Agente de IoT Edge y del centro de IoT Edge se etiquetan con la versión de IoT Edge a la que están asociadas. Hay dos maneras diferentes de usar etiquetas con las imágenes del entorno de ejecución:

• Etiquetas graduales: use solo los dos primeros valores del número de versión para obtener la imagen más reciente que coincida con esos dígitos. Por ejemplo, la versión 1.5 se actualiza cada vez que hay una nueva versión para que apunte a la versión 1.5.x más reciente. Si el entorno de ejecución del contenedor en el dispositivo IoT Edge extrae la imagen de nuevo, se actualizan los módulos del entorno de ejecución a la versión más reciente. Las implementaciones de Azure Portal tienen como valor predeterminado las etiquetas graduales. Este enfoque se sugiere con fines de desarrollo.

• Etiquetas específicas: use los tres valores del número de versión para establecer explícitamente la versión de la imagen. Por ejemplo, 1.5.0 no cambiará después de su lanzamiento inicial. Puede declarar un nuevo número de versión del manifiesto de implementación cuando esté listo para actualizar. Este enfoque se sugiere con fines de producción.

Actualización de una imagen de etiqueta gradual

Si usa etiquetas graduales en la implementación (por ejemplo, mcr.microsoft.com/azureiotedge-hub:1.5), debe forzar el tiempo de ejecución del contenedor en el dispositivo para extraer la versión más reciente de la imagen.

Elimine la versión local de la imagen del dispositivo IoT Edge. En equipos con Windows, al desinstalar el subsistema de seguridad también se quitan las imágenes en tiempo de ejecución, por lo que no es necesario volver a realizar este paso.

docker rmi mcr.microsoft.com/azureiotedge-hub:1.5
docker rmi mcr.microsoft.com/azureiotedge-agent:1.5

Es posible que tenga que usar la marca -f de fuerza para eliminar las imágenes.

El servicio IoT Edge extrae las versiones más recientes de las imágenes en tiempo de ejecución y las inicia automáticamente en el dispositivo de nuevo.

Actualización de una etiqueta específica

Si usa etiquetas específicas en la implementación (por ejemplo, mcr.microsoft.com/azureiotedge-hub:1.4), todo lo que debe hacer es actualizar la etiqueta en el manifiesto de implementación y aplicar los cambios en el dispositivo.

1. En IoT Hub en Azure Portal, seleccione el dispositivo IoT Edge y luego Establecer módulos.

2. En la pestaña Módulos, seleccione Configuración del entorno de ejecución.

3. En configuración del entorno de ejecución, actualice el valor de URI de imagen en la sección Agente Edge con la versión deseada. Por ejemplo, mcr.microsoft.com/azureiotedge-agent:1.5 no seleccione Aplicar aún.

4. Seleccione la pestaña Centro de Edge y actualice el valor URI de imagen con la misma versión deseada. Por ejemplo, mcr.microsoft.com/azureiotedge-hub:1.5.

5. Seleccione Aplicar para guardar los cambios.

6. Seleccione Revisar y crear, revise la implementación como se muestra en el archivo JSON y seleccione Crear.

Actualización de los URI del módulo de asociado

Si usa módulos de asociados, actualice las implementaciones del módulo con los URI de imagen proporcionados por el asociado. Póngase en contacto con el publicador del módulo IoT Edge para obtener el URI de imagen de contenedor actualizado. Actualice las configuraciones del dispositivo con el nuevo URI de imagen proporcionado por el publicador.

1. Inicie sesión en Azure Portal y vaya a su instancia de IoT Hub.
2. En el panel izquierdo, seleccione Dispositivos en el menú Administración de dispositivos.
3. Seleccione el dispositivo IoT Edge que usa el módulo asociado de la lista.
4. En la barra superior, seleccione Establecer módulos.
5. Elija el módulo de asociado de IoT Edge que desea actualizar con el nuevo URI de imagen.
6. Actualice el valor URI de imagen con el nuevo URI de imagen proporcionado por el publicador.
7. Seleccione Aplicar para guardar los cambios.
8. Seleccione Revisar y crear, revise la implementación como se muestra en el archivo JSON y seleccione Crear.

Comprobar que las versiones coincidan

1. En el dispositivo, use iotedge version para comprobar la versión del subsistema de seguridad. La salida incluye los números de versión principal, secundaria y de revisión. Por ejemplo, iotedge 1.4.2.

2. En la configuración del tiempo de ejecución de implementación del dispositivo, compruebe que las versiones URI de las imágenes edgeHub y edgeAgent coincidan con la versión principal y secundaria del subsistema de seguridad. Si la versión del subsistema de seguridad es 1.4.2, las versiones de imagen serían 1.4. Por ejemplo, mcr.microsoft.com/azureiotedge-hub:1.4 y mcr.microsoft.com/azureiotedge-agent:1.4.

Nota:

Actualice el subsistema de seguridad de IoT Edge y los contenedores en tiempo de ejecución a la misma versión de versión compatible. Aunque se admiten versiones no coincidentes, no se han probado todas las combinaciones de versiones.

Para obtener la versión más reciente de Azure IoT Edge, consulte Versiones de Azure IoT Edge.

Solución de problemas

Puede ver los registros del sistema en cualquier momento ejecutando los siguientes comandos desde el dispositivo.

• Empiece a solucionar problemas mediante el comandocomprobación. Ejecuta una colección de pruebas de configuración y conectividad para problemas comunes.

  sudo iotedge check --verbose
  

• Para ver el estado del sistema IoT Edge, ejecute:

  sudo iotedge system status 
  

• Para ver los registros de componentes de host, ejecute:

  sudo iotedge system logs
  

• Para comprobar si hay problemas periódicos notificados con edgeAgent y edgeHub, ejecute:

  Asegúrese de reemplazar <module> por su propio nombre de módulo. Si no hay ningún problema, no verá ninguna salida.

  sudo iotedge logs <module>
  

Para más información, consulte Solución de problemas del dispositivo IoT Edge.

Pasos siguientes

Consulte las últimas versiones de Azure IoT Edge.

Permanezca actualizado con los anuncios y las actualizaciones recientes del blog de Internet de las cosas.