Actualización de IoT Edge

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

Actualizar apt.

sudo apt-get update

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

apt list -a iotedge

Si desea actualizar a la versión más reciente del módulo en tiempo de ejecución, use el siguiente comando, que también actualiza libiothsm-std a la versión más reciente:

sudo apt-get install iotedge

Si desea actualizar a una versión específica del módulo en tiempo de ejecución, especifique la versión de la salida del comando apt list. Cada vez que iotedge se actualiza, intenta actualizar automáticamente el paquete libiothsm-std a su versión más reciente, lo que puede provocar conflictos de dependencias. Si no va a la versión más reciente, asegúrese de tener como destino ambos paquetes para la misma versión. Por ejemplo, el siguiente comando instala una versión específica de la versión 1.1:

sudo apt-get install iotedge=1.1.1 libiothsm-std=1.1.1

Si la versión que quiere instalar no está disponible a través de apt-get, puede usar curl para acceder a cualquier versión del repositorio de lanzamientos de IoT Edge. Para cualquier versión que desee instalar, busque los archivos libiothsm-std y iotedge para su dispositivo. Para cada archivo, haga clic con el botón derecho en el vínculo del archivo y copie la dirección del vínculo. Use la dirección de vínculo para instalar las versiones específicas de esos componentes:

curl -L <libiothsm-std link> -o libiothsm-std.deb && sudo apt-get install ./libiothsm-std.deb
curl -L <iotedge link> -o iotedge.deb && sudo apt-get install ./iotedge.deb

La versión 1.1 de IoT Edge no se admite en Red Hat Enterprise Linux 8.

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

Con IoT Edge para Windows, IoT Edge se ejecuta directamente en el dispositivo Windows.

Use el comando Update-IoTEdge para actualizar el entorno de ejecución del módulo. El script extrae automáticamente la versión más reciente del entorno de ejecución del módulo.

. {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; Update-IoTEdge

Al ejecutar el comando Update-IoTEdge se elimina y se actualiza el módulo de ejecución de tu dispositivo, junto con las dos imágenes de contenedor de ejecución. El archivo config.yaml se mantiene en el dispositivo, así como los datos del motor de contenedores Moby. Mantener la información de configuración significa que no tiene que proporcionar la cadena de conexión o la información del servicio Device Provisioning para el dispositivo de nuevo durante el proceso de actualización.

Si quiere actualizar a una versión específica del subsistema de seguridad, busque la versión del canal de lanzamiento 1.1 a la que quiere dirigirse desde versiones de IoT Edge. En esa versión, descargue el archivo Microsoft-Azure-IoTEdge.cab. A continuación, use el parámetro -OfflineInstallationPath para apuntar a la ubicación del archivo local. Por ejemplo:

. {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; Update-IoTEdge -OfflineInstallationPath <absolute path to directory>

Si desea actualizar un dispositivo sin conexión, busque la versión que desea desde las versiones de Azure IoT Edge. En esa versión, descargue los archivos IoTEdgeSecurityDaemon.ps1 y Microsoft-Azure-IoTEdge.cab. Es importante usar el script de PowerShell de la misma versión que el archivo de .cab que usa porque la funcionalidad cambia para admitir las características de cada versión.

Si el archivo .cab que descargó tiene un sufijo de arquitectura en él, cambie el nombre del archivo a solo Microsoft-Azure-IoTEdge.cab.

Para actualizar con componentes sin conexión, , utilice punto-origen en la copia local del script de PowerShell. A continuación, use el parámetro -OfflineInstallationPath como parte del comando Update-IoTEdge y proporcione la ruta de acceso absoluta al directorio de archivos. Por ejemplo

. <path>\IoTEdgeSecurityDaemon.ps1
Update-IoTEdge -OfflineInstallationPath <path>

Para obtener más información sobre las opciones de actualización, use el comando Get-Help Update-IoTEdge -full o consulte scripts de PowerShell para IoT Edge con contenedores de Windows.

A partir de la versión 1.2, el servicio IoT Edge usa un nuevo nombre de paquete y tiene algunas diferencias en los procesos de instalación y configuración. Si tiene un dispositivo IoT Edge que ejecute la versión 1.0 o 1.1, siga estas instrucciones para obtener información sobre cómo actualizar a la versión más reciente.

Algunas de las principales diferencias entre la versión más reciente y la versión 1.1 y anteriores incluyen:

• El nombre del paquete cambió de iotedge a aziot-edge.
• El paquete libiothsm-std ya no se usa. Si usó el paquete estándar proporcionado como parte de la versión de IoT Edge, las configuraciones se pueden transferir a la nueva versión. Si ha usado una implementación diferente de libiothsm-std, los certificados proporcionados por el usuario, como el certificado de identidad del dispositivo, la ENTIDAD de certificación del dispositivo y el conjunto de confianza, deben volver a configurarse.
• Se introdujo un nuevo servicio de identidad, aziot-identity-service como parte de la versión 1.2. Este servicio controla el aprovisionamiento y la administración de identidades para IoT Edge y para otros componentes de dispositivo que necesitan comunicarse con IoT Hub, como Device Update para IoT Hub.
• El archivo de configuración predeterminado tiene un nombre y una ubicación nuevos. Anteriormente /etc/iotedge/config.yaml, ahora se espera que la información de configuración del dispositivo esté en /etc/aziot/config.toml de forma predeterminada. El comando iotedge config import se puede usar para ayudar a migrar la información de configuración de la ubicación y la sintaxis anteriores a las nuevas.
  • El comando import no puede detectar ni modificar reglas de acceso al módulo de plataforma segura (TPM) de un dispositivo. Si el dispositivo usa la atestación de TPM, debe actualizar manualmente el archivo /etc/udev/rules.d/tpmaccess.rules para conceder acceso al servicio aziottpm. Para obtener más información, consulte Dar acceso de IoT Edge al TPM.
• La API de carga de trabajo de la versión más reciente guarda los secretos cifrados en un nuevo formato. Si actualiza de una versión anterior a la versión más reciente, se importa la clave de cifrado maestra existente. La API de carga de trabajo puede leer secretos guardados en el formato anterior mediante la clave de cifrado importada. Sin embargo, la API de carga de trabajo no puede escribir secretos cifrados en el formato anterior. Una vez que un módulo vuelve a cifrar un secreto, se guarda en el nuevo formato. Los secretos cifrados en la versión más reciente no son legibles por el mismo módulo de la versión 1.1. Si conserva los datos cifrados en una carpeta o volumen montados en el host, cree siempre una copia de seguridad de los datos antes de actualizar para conservar la capacidad de retroceder si es necesario.
• Por motivos de compatibilidad con versiones anteriores al conectar dispositivos que no admiten TLS 1.2, puede configurar edge Hub para que siga aceptando TLS 1.0 o 1.1 a través de la variable de entorno SslProtocols de . Tenga en cuenta que la compatibilidad con TLS 1.0 y 1.1 en IoT Hub se considera obsoleta y podría también eliminarse de Edge Hub en futuras versiones. Para evitar problemas futuros, use TLS 1.2 como la única versión de TLS al conectarse a Edge Hub o IoT Hub.
• La versión preliminar del agente MQTT experimental de Edge Hub 1.2 ha finalizado y no se incluye en Edge Hub 1.3 o posterior. Seguimos refinando nuestros planes para un agente MQTT en función de los comentarios recibidos. Mientras tanto, si necesita un agente MQTT compatible con estándares en IoT Edge, considere la posibilidad de implementar un agente de código abierto como Mosquitto como un módulo ioT Edge.
• A partir de la versión 1.2, cuando se quita una imagen de respaldo de un contenedor, el contenedor sigue ejecutándose y se conserva durante los reinicios. En la versión 1.1, cuando se quita una imagen de respaldo, el contenedor se vuelve a crear inmediatamente y se actualiza la imagen de respaldo.

Antes de automatizar los procesos de actualización, valide que funciona en máquinas de prueba.

Cuando esté listo, siga estos pasos para actualizar IoT Edge en los dispositivos:

1. Actualizar apt.

   sudo apt-get update
   

2. Desinstale la versión anterior de IoT Edge, dejando los archivos de configuración implementados.

   sudo apt-get remove iotedge
   

3. Instale la versión más reciente de IoT Edge, junto con el servicio de identidad de IoT y el microagente de Microsoft Defender para IoT para Edge.

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

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

1. Importe el archivo config.yaml antiguo en su nuevo formato y aplique la información de configuración.

   sudo iotedge config import
   

La versión 1.1 de IoT Edge no se admite en Red Hat Enterprise Linux 8.

Si usa contenedores de Windows o IoT Edge para Linux en Windows, esta sección especial no se aplica.

Actualmente, no hay compatibilidad con ioT Edge versión 1.2 o posterior que se ejecute en dispositivos Windows.