Passer à une nouvelle version

Mettez à niveau un déploiement Opérations Azure IoT vers une version plus récente. Opérations Azure IoT prend en charge la mise à niveau à partir de la version 1.0.x et versions ultérieures. Il n’existe aucune prise en charge de la mise à niveau à partir d’une préversion des opérations Azure IoT vers une version en disponibilité générale.

Prérequis

• Azure CLI. Ce scénario nécessite Azure CLI version 2.53.0 ou ultérieure. Utilisez az --version pour vérifier votre version et az upgrade pour effectuer une mise à jour si nécessaire. Pour plus d’informations, consultez Prise en main d’Azure CLI.

• Extension Opérations Azure IoT pour Azure CLI. Utilisez la commande suivante pour ajouter l’extension ou la mettre à jour vers la dernière version :

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

Présentation de la prise en charge de la mise à niveau

Vous pouvez mettre à niveau une instance d’Opérations Azure IoT existante vers n’importe quel correctif de la même version mineure ou vers la version mineure suivante.

Opérations Azure IoT ne prend pas en charge la rétrogradation entre les versions. Pour passer à une version antérieure, désinstallez Opérations Azure IoT et réinstallez la version souhaitée.

Remarque

Azure IoT Operations ne prend pas en charge les mises à niveau actives. Attendez-vous à un temps d’arrêt pendant le processus de mise à niveau.

Mettre à jour

Opérations Azure IoT prend en charge la mise à niveau d’instances vers de nouvelles versions en disponibilité générale à mesure qu’elles sont publiées.

Vous ne pouvez pas effectuer une mise à niveau d’une préversion vers une version en disponibilité générale. Pour passer à la version 1.0.x, désinstallez Opérations Azure IoT et réinstallez la nouvelle version.

portail Azure

Si votre déploiement Opérations Azure IoT est éligible à une mise à niveau, le Portail Azure affiche une option Mettre à niveau. Si vous ne voyez pas l’option de mise à niveau, votre déploiement se trouve sur la dernière version.

1. Dans le Portail Azure, accédez à votre instance Opérations Azure IoT.

2. Sélectionnez Mettre à niveau dans la page Vue d’ensemble de votre instance.

   

3. Vous devez utiliser la dernière version de l’extension CLI Opérations Azure IoT pour obtenir la dernière version d’Opérations Azure IoT. Si vous n’avez pas mis à jour l’extension dans le cadre des prérequis, faites-le maintenant.

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

   Ou, si vous souhaitez mettre à niveau votre déploiement vers une version plus récente, mais pas la dernière, définissez la version de l’extension CLI sur celle associée à vos versions d’Opérations Azure IoT souhaitées dans Versions d’Opérations IoT.

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

4. Le portail présente la commande Azure CLI pour mettre à niveau votre instance, préremplie avec vos informations d’abonnement, de groupe de ressources et d’instance. Sélectionnez l’icône de copie à côté de la commande CLI.

5. Exécutez la commande az iot ops upgrade copiée.

6. Une fois la commande de mise à niveau effectuée, actualisez votre instance pour voir les modifications.

La valeur Version affichée sur la page de vue d’ensemble de votre instance reflète la version de l’instance Opérations Azure IoT. Toutefois, vous pouvez être invité à effectuer une mise à niveau si une extension Arc requise dispose d’une mise à niveau disponible. Vous pouvez indiquer qu’une mise à niveau a réussi si l’option Mettre à niveau disparaît de la page vue d’ensemble de l’instance, même si rien ne semble avoir changé. Vous pouvez vérifier les versions des extensions Arc pour votre déploiement Opération Azure IoT sur la page Extensions de votre cluster avec Arc dans le Portail Azure.

Azure CLI

Utilisez la commande az iot ops upgrade pour mettre à niveau un déploiement Opérations Azure IoT existant vers une version plus récente.

La commande de mise à niveau évalue l’ensemble du déploiement des opérations Azure IoT pour les mises à jour disponibles, y compris les extensions Arc installées dans la commande az iot ops init et l’instance Azure IoT Operations.

Effectuez ces étapes pour mettre à niveau votre déploiement vers la dernière version :

1. Vous devez utiliser la dernière version de l’extension CLI Opérations Azure IoT pour obtenir la dernière version d’Opérations Azure IoT. Si vous n’avez pas mis à jour l’extension dans le cadre des prérequis, faites-le maintenant.

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

2. Exécutez az iot ops upgrade

   az iot ops upgrade --resource-group <RESOURCE_GROUP_NAME> --name <INSTANCE_NAME>
   

3. L’interface CLI génère une table des composants qui ont des mises à niveau disponibles. Entrez Y pour poursuivre la mise à niveau.

Si vous souhaitez effectuer une mise à niveau vers une version spécifique d’Opérations Azure IoT qui n’est pas la plus récente, utilisez la version d’extension CLI associée. Chaque version d’Opérations Azure IoT est mappée à une version de l’extension CLI Opérations Azure IoT.

Consultez Versions d’Opérations IoT pour rechercher la version de l’extension CLI associée à la version d’Opérations Azure IoT souhaitée. Ensuite, mettez à niveau l’extension CLI :

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

Considérations relatives à la mise à niveau du répartiteur MQTT

Pour garantir aucune perte de données et une haute disponibilité pendant les mises à niveau du déploiement, le courtier MQTT implémente les mises à jour continues sur les pods du courtier MQTT. Le pod du gestionnaire d’intégrité coordonne un processus de mise à niveau incrémentielle pour les pods MQTT broker pour vous assurer que :

• Les connexions clientes actives restent ininterrompues.
• Tous les messages en transit sont conservés.
• Les données stockées sur le disque sont correctement migrées entre les versions.

Si une défaillance se produit pendant le processus de mise à niveau, le pod du gestionnaire d’intégrité redémarre automatiquement le processus de mise à niveau tout en veillant à ce qu'il n'y ait aucune perte de données ni de connectivité.

Les mises à jour propagées peuvent se produire uniquement si le MQTT broker est déployé avec deux répliques back-end ou plus. Les mises à niveau du courtier MQTT ne sont pas prises en charge pour les déploiements à réplique unique. Lorsque vous déployez Azure IoT Operations, vous spécifiez le nombre de réplicas back-end à créer dans la commande az iot ops create avec le --broker-backend-rf paramètre.