Passer à une nouvelle version

Découvrez comment mettre à niveau un déploiement Azure IoT Operations vers une version plus récente.

Prérequis

• Un compte Azure avec un abonnement actif. Si vous n’avez pas de compte, vous pouvez créer un compte gratuit.
• 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.

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

Les versions de publication d’Azure IoT Operations peuvent être en préversion ou généralement disponibles (GA). Vous pouvez trouver la dernière version dans le document des versions d’Azure IoT Operations. La version de l’extension Azure IoT Operations CLI est liée à la version Azure IoT Operations. Vous devez donc vous assurer que la version correcte de l’extension CLI est installée pour effectuer une mise à niveau.

Azure IoT Operations prend en charge les scénarios de mise à niveau suivants :

• 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.
• Vous ne pouvez pas rétrograder entre les versions. Pour passer à une version antérieure, désinstallez Azure IoT Operations et réinstallez la version souhaitée.
• Vous ne pouvez pas effectuer de mise à niveau à partir d’une préversion vers une version en disponibilité générale. Vous devez désinstaller Azure IoT Operations et réinstaller la nouvelle version.
• Vous ne pouvez pas effectuer de mise à niveau à partir d’une version en disponibilité générale vers une préversion. Pour plus d’informations sur l’installation d’une préversion, consultez Mise à niveau vers la version préliminaire.

Mettre à niveau

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. Si votre instance Azure IoT Operations est éligible à une mise à niveau, vous pouvez utiliser le Portail Microsoft Azure ou Azure CLI pour effectuer la mise à niveau.

Si la dernière version des opérations Azure IoT est en préversion, consultez Mise à niveau vers la version préliminaire.

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

Mettre à niveau vers la préversion

Parfois, la dernière version d’Azure IoT Operations est en version préliminaire. Consultez les versions d’Azure IoT Operations pour voir la dernière version. Pendant les préversions, la mise à niveau de version est bloquée et vous devez désinstaller Azure IoT Operations et réinstaller la version préliminaire.

Vous ne pouvez installer qu’une version préliminaire à l’aide de l’interface de ligne de commande Azure.

1. Si vous disposez d’une instance Azure IoT Operations existante, vous devez désinstaller Azure IoT Operations pour effectuer un nouveau déploiement.

2. Ajoutez la dernière version de l’extension Azure IoT Operations CLI avec l’indicateur --allow-preview.

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

Si vous souhaitez effectuer une mise à niveau vers une version spécifique d’Azure IoT Operations qui n’est pas la plus récente, vous pouvez exécuter az iot ops get-versions ou vous référer aux versions d’IoT Operations pour trouver la version d’extension CLI associée à la version d’Azure IoT Operations souhaitée. Obtenez le numéro de version et exécutez la commande suivante pour effectuer la mise à niveau vers cette version :

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.

Versions prises en charge

Microsoft prend en charge trois versions en disponibilité générale d’Azure IoT Operations à tout moment : la dernière version et les deux versions mineures précédentes. En outre, les versions préliminaires sont disponibles pour tester de nouvelles fonctionnalités.

Actuellement, la prise en charge d’Azure est disponible pour les versions suivantes :

Pour en savoir plus sur les mises à niveau entre les versions, consultez Mettre à niveau vers une nouvelle version.

Pour vérifier votre version actuelle, accédez à la page vue d’ensemble de votre instance Azure IoT Operations dans le portail Azure ou utilisez la commande Show de l’instance Azure IoT Operations CLI az iot ops .