Upgraden naar een nieuwe versie

Meer informatie over het upgraden van een Azure IoT Operations-implementatie naar een nieuwere versie.

Vereiste voorwaarden

• Een Azure-account met een actief abonnement. Als u geen account hebt, kunt u een gratis account maken.
• Azure CLI versie 2.53.0 of hoger. Gebruik az --version om uw versie te controleren en az upgrade om indien nodig bij te werken. Zie Aan de slag met Azure CLI voor meer informatie.

Meer informatie over upgradeondersteuning

Releaseversies van Azure IoT Operations kunnen preview of algemeen beschikbaar zijn (GA), u vindt de nieuwste versie in het document met Azure IoT Operations-versies . De Versie van de Azure IoT Operations CLI-extensie is gekoppeld aan de Versie van Azure IoT Operations, dus u moet ervoor zorgen dat u de juiste CLI-extensieversie hebt geïnstalleerd om een upgrade uit te voeren.

Azure IoT Operations ondersteunt de volgende upgradescenario's:

• U kunt een bestaand Azure IoT Operations-exemplaar upgraden naar een patch van dezelfde secundaire versie of naar de volgende secundaire versie.
• U kunt niet downgraden tussen versies. Als u naar een oudere versie wilt gaan, verwijdert u Azure IoT Operations en installeert u de gewenste versie opnieuw.
• U kunt geen upgrade uitvoeren van een preview-versie naar een GA-versie. U moet Azure IoT Operations verwijderen en de nieuwe versie opnieuw installeren.
• U kunt geen upgrade uitvoeren van een GA-versie naar een preview-versie. Zie Upgraden naar preview-versie voor meer informatie over het installeren van een preview-versie.

Opmerking

Azure IoT Operations biedt geen ondersteuning voor live upgrades. Verwacht enige downtime tijdens het upgradeproces.

Opwaarderen

Azure IoT Operations biedt ondersteuning voor het upgraden van exemplaren naar nieuwe GA-versies wanneer ze worden uitgebracht. Als uw Azure IoT Operations-exemplaar in aanmerking komt voor een upgrade, kunt u Azure Portal of de Azure CLI gebruiken om de upgrade uit te voeren.

Als de nieuwste versie van Azure IoT Operations in preview is, raadpleegt u Upgraden naar preview-versie.

Azure-portal

Als uw Azure IoT Operations-implementatie in aanmerking komt voor een upgrade, wordt in Azure Portal een upgradeoptie weergegeven. Als u de optie voor het upgraden niet ziet, bevindt uw implementatie zich in de nieuwste versie.

1. Navigeer in Azure Portal naar uw Azure IoT Operations-exemplaar.

2. Selecteer Upgraden op de pagina Overzicht van uw exemplaar.

   

3. U moet de nieuwste versie van de Azure IoT Operations CLI-extensie gebruiken om de nieuwste versie van Azure IoT Operations op te halen. Als u de extensie niet hebt bijgewerkt als onderdeel van de vereisten, doet u dit nu.

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

   Als u uw implementatie wilt upgraden naar een nieuwere versie, maar niet naar de meest recente versie, stelt u de CLI-extensieversie in op de versie die is gekoppeld aan de gewenste Azure IoT Operations-versies in IoT Operations-versies.

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

4. Via het portaal wordt het Azure CLI-commando weergegeven om uw exemplaar bij te werken, vooraf ingevuld met uw abonnement, resourcegroep en instantiedetails. Selecteer het kopieerpictogram naast de CLI-opdracht.

5. Voer de gekopieerde az iot ops upgrade opdracht uit.

6. Nadat de upgradeopdracht is voltooid, vernieuwt u uw exemplaar om de wijzigingen te zien.

De versiewaarde die wordt weergegeven op de overzichtspagina van uw exemplaar, weerspiegelt de versie van het Azure IoT Operations-exemplaar. Mogelijk wordt u echter gevraagd om een upgrade uit te voeren als een vereiste Arc-extensie een beschikbare upgrade heeft. U kunt zien dat een upgrade is geslaagd als de optie Upgrade verdwijnt van de overzichtspagina van het exemplaar, zelfs als deze niet lijkt op iets dat is gewijzigd. U kunt de versies van de Arc-extensies voor uw Azure IoT-bewerkingsimplementatie controleren op de pagina Extensies van uw Cluster met Arc in Azure Portal.

Azure-CLI

Gebruik de opdracht az iot ops upgrade om een bestaande Azure IoT Operations-implementatie te upgraden naar een nieuwere versie.

Met de upgradeopdracht wordt de volledige Implementatie van Azure IoT Operations geëvalueerd op beschikbare updates, inclusief de arc-extensies die zijn geïnstalleerd in de az iot ops init opdracht en het Azure IoT Operations-exemplaar.

Voer de volgende stappen uit om uw implementatie bij te werken naar de nieuwste versie:

1. Voeg de nieuwste versie van de Azure IoT Operations CLI-extensie toe.

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

2. Voer az iot ops upgrade uit

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

3. De CLI voert een tabel uit van de onderdelen met beschikbare upgrades. Voer in Y om door te gaan met de upgrade.

Als u een upgrade wilt uitvoeren naar een specifieke versie van Azure IoT Operations die niet de meest recente versie is, kunt u az iot ops get-versions uitvoeren of raadplegen om de CLI-extensieversie te vinden die is gekoppeld aan de gewenste Versie van Azure IoT Operations. Haal het versienummer op en voer de volgende opdracht uit om een upgrade naar die versie uit te voeren:

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

Upgraden naar preview-versie

Soms is de nieuwste versie van Azure IoT Operations in preview. Controleer de Azure IoT Operations-versies om de nieuwste versie te zien. Tijdens preview-versies wordt de versie-upgrade geblokkeerd en moet u Azure IoT Operations verwijderen en de preview-versie opnieuw installeren.

U kunt alleen een preview-versie installeren met behulp van de Azure CLI.

1. Als u een bestaand Exemplaar van Azure IoT Operations hebt, moet u Azure IoT-bewerkingen verwijderen om een nieuwe implementatie uit te voeren.

2. Voeg de nieuwste versie van de Azure IoT Operations CLI-extensie toe met de --allow-preview vlag.

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

Als u een upgrade wilt uitvoeren naar een specifieke versie van Azure IoT Operations die niet de meest recente versie is, kunt u az iot ops get-versions uitvoeren of raadplegen om de CLI-extensieversie te vinden die is gekoppeld aan de gewenste Versie van Azure IoT Operations. Haal het versienummer op en voer de volgende opdracht uit om een upgrade naar die versie uit te voeren:

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

Overwegingen bij het upgraden van MQTT-broker

Om ervoor te zorgen dat er geen gegevensverlies en hoge beschikbaarheid tijdens de implementatie-upgrades zijn, implementeert de MQTT-broker rolling updates in de MQTT-brokerpods. De Health Manager-pod coördineert een incrementeel upgradeproces voor de MQTT-brokerpods om ervoor te zorgen dat:

• Actieve clientverbindingen blijven ononderbroken.
• Alle in-flight-berichten blijven behouden.
• Gegevens die op schijf zijn opgeslagen, worden correct gemigreerd tussen versies.

Als er een fout optreedt tijdens het upgradeproces, start de Health Manager-pod het upgradeproces automatisch opnieuw op terwijl er geen verlies van gegevens of connectiviteit mogelijk is.

Rolling updates kunnen alleen worden uitgevoerd als de MQTT-broker is uitgerold met twee of meer back-endreplica's. MQTT Broker-upgrades worden niet ondersteund voor implementaties met één replica. Wanneer u Azure IoT Operations implementeert, geeft u het aantal back-endreplica's op dat moet worden gemaakt in de opdracht az iot ops create met de --broker-backend-rf parameter.

Ondersteunde versies

Microsoft ondersteunt op elk gewenst moment drie algemeen beschikbare (GA) versies van Azure IoT Operations: de nieuwste versie en de twee vorige secundaire versies. Daarnaast zijn preview-versies beschikbaar voor het testen van nieuwe functies.

Momenteel is Azure-ondersteuning beschikbaar voor de volgende versies:

Versie	Typologie	Huidige patch release (JJMM)	Actueel CLI-versie	Opmerkingen bij de uitgave
1.2.x	Algemene Vergadering	1.2.112 (2510)	2.0.1	Opmerkingen bij de release
1.1.x	Algemene Vergadering	1.1.59 (2506)	1.7.0	Opmerkingen bij de release
1.0.x	Algemene Vergadering	1.0.34 (2503)	1.3.0	Opmerkingen bij de release

Zie Upgraden naar een nieuwe versie voor meer informatie over upgrades tussen versies.

Belangrijk

Eerdere secundaire versies ontvangen geen beveiligingspatches. Voer een upgrade uit naar de nieuwste versie om de nieuwste beveiligingsupdates en -functies op te halen.

Waarschuwing

Gebruik geen preview-versies in productieomgevingen.

Als u uw huidige versie wilt controleren, gaat u naar de overzichtspagina voor uw Azure IoT Operations-exemplaar in Azure Portal of gebruikt u de azure IoT Operations CLI az iot ops instance show command.