Compartir a través de

Actualización a una nueva versión

Actualice una implementación de Operaciones de IoT de Azure a una versión más reciente. Operaciones de IoT de Azure es compatible con la actualización a partir de la versión 1.0.x. No se admite la actualización desde ninguna versión preliminar de Azure IoT Operations a cualquier versión disponible con carácter general (GA).

Requisitos previos

  • CLI de Azure. Este escenario requiere la versión 2.53.0 o posterior de la CLI de Azure. Use az --version para comprobar la versión y az upgrade para actualizarla si es necesario. Para más información, consulte Introducción a la CLI de Azure.

  • Extensión Operaciones de IoT de Azure para la CLI de Azure. Use el siguiente comando para agregar la extensión o actualizarla a la versión más reciente:

    az extension add --upgrade --name azure-iot-ops

Descripción de la compatibilidad con la actualización

Puede actualizar una instancia de Operaciones de IoT de Azure existente a cualquier revisión de la misma versión secundaria o a la siguiente versión secundaria.

Operaciones de IoT de Azure no admite la degradación entre versiones. Para pasar a una versión anterior, desinstale Operaciones de IoT de Azure y vuelva a instalar la versión deseada.

Nota:

Azure IoT Operations no admite actualizaciones dinámicas. Espere algún tiempo de inactividad durante el proceso de actualización.

Actualizar

Operaciones de IoT de Azure es compatible con la actualización de las instancias a las nuevas versiones de GA a medida que se publican.

No se puede actualizar desde una instalación de versión preliminar a una versión de disponibilidad general. Para pasar a la versión 1.0.x, desinstale Operaciones de IoT de Azure y vuelva a instalar la nueva versión.

Si la implementación de Operaciones de IoT de Azure es apta para una actualización, Azure Portal muestra una opción de actualización. Si no ve la opción de actualización, la implementación se encuentra en la versión más reciente.

  1. En Azure Portal, vaya a su instancia de Operaciones de IoT de Azure.

  2. Seleccione Actualizar en la página de información general de la instancia.

    Captura de pantalla que muestra el botón Actualizar en Azure Portal

  3. Debe usar la versión más reciente de la extensión de la CLI de Operaciones de IoT de Azure para obtener la versión más reciente de Operaciones de IoT de Azure. Si no actualizó la extensión como parte de los requisitos previos, hágalo ahora.

    az extension add --upgrade --name azure-iot-ops

    O bien, si quiere actualizar la implementación a una versión más reciente, pero no a la más reciente, establezca la versión de la extensión de la CLI en la asociada a las versiones de Operaciones de IoT de Azure deseadas en las versiones de Operaciones de IoT.

    az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>

  4. El portal presenta el comando de la CLI de Azure para actualizar la instancia, rellenada previamente con la suscripción, el grupo de recursos y los detalles de la instancia. Seleccione el icono de copia situado junto al comando de la CLI.

  5. Ejecute el comando copiado az iot ops upgrade.

  6. Después de completar correctamente el comando de actualización, actualice la instancia para ver los cambios.

El valor Versión que se muestra en la página de información general de la instancia refleja la versión de la instancia de Operaciones de IoT de Azure. Sin embargo, es posible que se le pida que actualice si una extensión de Arc necesaria tiene una actualización disponible. Puede indicar que una actualización se realizó correctamente si la opción Actualizar desaparece de la página de información general de la instancia, aunque no parezca que haya cambiado nada. Puede comprobar las versiones de las extensiones de Arc para la implementación de Operaciones de IoT de Azure en la página Extensiones del clúster habilitado para Arc en Azure Portal.

Consideraciones sobre la actualización del agente MQTT

Para garantizar la pérdida de datos cero y la alta disponibilidad durante las actualizaciones de implementación, el agente MQTT implementa actualizaciones graduales en los pods del agente MQTT. El pod del administrador de mantenimiento coordina un proceso de actualización incremental para los pods del corredor MQTT para asegurarse de que:

  • Las conexiones de cliente activas permanecen ininterrumpidas.
  • Se conservan todos los mensajes en curso.
  • Los datos almacenados en el disco se migran correctamente entre versiones.

Si se produce un error durante el proceso de actualización, el pod del administrador de mantenimiento reinicia automáticamente el proceso de actualización, a la vez que garantiza que no se pierdan datos ni conectividad.

Las actualizaciones graduales solo se pueden producir si el agente MQTT se implementa con dos o más réplicas de back-end. Las actualizaciones del broker MQTT no son compatibles con implementaciones de réplica única. Al implementar Azure IoT Operations, especifique el número de réplicas de back-end que se van a crear en el comando az iot ops create con el --broker-backend-rf parámetro .