Compartir a través de

Actualización a una nueva versión

Obtenga información sobre cómo actualizar una implementación de Operaciones de IoT de Azure a una versión más reciente.

Requisitos previos

  • Una cuenta de Azure con una suscripción activa. Si no tiene una cuenta, puede crear una cuenta gratuita.
  • CLI de Azure versión 2.53.0 o posterior. Use az --version para comprobar la versión y az upgrade para actualizar si es necesario. Para más información, consulte Introducción a la CLI de Azure.

Descripción de la compatibilidad con la actualización

Las versiones de la versión de Operaciones de IoT de Azure pueden estar disponibles en versión preliminar o disponibles con carácter general; puede encontrar la versión más reciente en el documento Versiones de Operaciones de IoT de Azure. La versión de la extensión de la CLI de Operaciones de IoT de Azure está vinculada a la versión de Operaciones de IoT de Azure, por lo que debe asegurarse de que tiene instalada la versión correcta de la extensión de la CLI para realizar una actualización.

Operaciones de IoT de Azure admite los siguientes escenarios de 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.
  • No se puede cambiar a una versión anterior entre versiones. Para pasar a una versión anterior, desinstale Operaciones de IoT de Azure y vuelva a instalar la versión deseada.
  • No se puede actualizar desde ninguna versión preliminar a una versión de disponibilidad general. Debe desinstalar Operaciones de IoT de Azure y volver a instalar la nueva versión.
  • No se puede actualizar desde ninguna versión de disponibilidad general a una versión preliminar. Para obtener más información sobre cómo instalar una versión preliminar, consulte Actualización a versión preliminar.

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. Si la instancia de Operaciones de IoT de Azure es apta para una actualización, puede usar Azure Portal o la CLI de Azure para realizar la actualización.

Si la versión más reciente de Operaciones de IoT de Azure está en versión preliminar, consulte Actualización a versión preliminar.

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.

Actualización a la versión preliminar

A veces, la versión más reciente de Operaciones de IoT de Azure está en versión preliminar. Compruebe las versiones de Operaciones de IoT de Azure para ver la versión más reciente. Durante las versiones preliminares, se bloquea la actualización de la versión y debe desinstalar Operaciones de IoT de Azure y volver a instalar la versión preliminar.

Solo puede instalar una versión preliminar mediante la CLI de Azure.

  1. Si tiene una instancia de Operaciones de IoT de Azure existente, debe desinstalar Operaciones de IoT de Azure para realizar una nueva implementación.

  2. Agregue la versión más reciente de la extensión de la CLI de Operaciones de IoT de Azure con la marca --allow-preview.

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

Si quiere actualizar a una versión específica de Operaciones de IoT de Azure que no es la más reciente, puede ejecutar az iot ops get-versions o hacer referencia a las versiones de Operaciones de IoT para encontrar la versión de la extensión de la CLI asociada a la versión de Operaciones de IoT de Azure que desee. Obtenga el número de versión y ejecute el siguiente comando para actualizar a esa versión:

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

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 .

Versiones compatibles

Microsoft admite tres versiones disponibles con carácter general (GA) de Operaciones de IoT de Azure en cualquier momento: la versión más reciente y las dos versiones secundarias anteriores. Además, las versiones preliminares están disponibles para probar nuevas características.

Actualmente, la compatibilidad con Azure está disponible para las siguientes versiones:

Versión Tipo Parche actual
lanzamiento (YYMM)		 Current
Versión de la CLI		 Notas de lanzamiento
1.2.x GA 1.2.112 (2510) 2.0.1 Notas de la versión
1.1.x GA 1.1.59 (2506) 1.7.0 Notas de la versión
1.0.x GA 1.0.34 (2503) 1.3.0 Notas de la versión

Para obtener información sobre las actualizaciones entre versiones, consulte Actualización a una nueva versión.

Importante

Las versiones secundarias anteriores no reciben revisiones de seguridad. Actualice a la versión más reciente para obtener las últimas actualizaciones y características de seguridad.

Advertencia

No use versiones preliminares en entornos de producción.

Para comprobar la versión actual, vaya a la página de información general de la instancia de Operaciones de IoT de Azure en Azure Portal o use el comando az iot ops instance show de la CLI de Operaciones de IoT de Azure.

  • Last updated on