Upgraden of downgraden tussen versies

Een Azure IoT Operations-implementatie upgraden naar een nieuwere versie of terugdraaien naar een vorige versie. Azure IoT Operations ondersteunt upgrades en terugdraaien vanaf versie 1.0.x. Er is geen ondersteuning voor het upgraden van een preview-versie van Azure IoT Operations naar een algemeen beschikbare versie (GA).

Vereisten

• Azure CLI. Voor dit scenario is Azure CLI versie 2.64.0 of hoger vereist. Gebruik az --version deze optie om uw versie te controleren en az upgrade zo nodig bij te werken. Zie Aan de slag met Azure CLI voor meer informatie.

• De Azure IoT Operations-extensie voor Azure CLI. Gebruik de volgende opdracht om de extensie toe te voegen of bij te werken naar de nieuwste versie:

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

Meer informatie over upgradeondersteuning

Upgraden en terugdraaien worden ondersteund tussen N+3- of N-3 secundaire versies van Azure IoT Operations of tussen patchversies van dezelfde secundaire versie. De volgende tabel bevat voorbeelden:

Versie	Upgradebereik	Downgradebereik
1.0.0	1.0.1 tot en met 1.3.x	Geen
1.1.0	1.1.1 tot en met 1.4.x	1.0.x
1.4.4	1.4.5 tot en met 1.7.x	1.1.x tot en met 1.4.3

Upgraden

Azure IoT Operations biedt ondersteuning voor het upgraden van exemplaren naar nieuwe GA-versies wanneer ze worden uitgebracht.

U kunt geen upgrade uitvoeren van een preview-installatie naar een GA-versie. Als u naar versie 1.0.x wilt gaan, verwijdert u Azure IoT Operations en installeert u de nieuwe versie opnieuw.

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. In de portal wordt de Azure CLI-opdracht weergegeven om uw exemplaar bij te werken, vooraf ingevuld met uw abonnement, resourcegroep en instantiedetails. Selecteer het kopieerpictogram naast de CLI-opdracht.

4. Voer de gekopieerde az iot ops upgrade opdracht uit in een omgeving waarop de Azure CLI is geïnstalleerd.

5. 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. U wordt echter mogelijk 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 in de az iot ops init opdracht zijn geïnstalleerd, evenals het Azure IoT Operations-exemplaar.

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

De CLI voert een tabel uit van de onderdelen, indien aanwezig, die beschikbare upgrades hebben. Voer in Y om door te gaan met de upgrade.

Als u een upgrade wilt uitvoeren naar een specifieke versie van een onderdeel, geeft u het versienummer op in de parameters. Voorbeeld:

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

U vindt de ondersteunde onderdeelversies en release-informatie in het azure-iot-operations-enablement.json-bestand dat is opgenomen in een opgegeven Versie van Azure IoT Operations.

Downgrade

Azure-portal

Azure Portal biedt geen optie voor het downgraden van versies. Gebruik in plaats daarvan de Azure CLI.

Azure-CLI

Gebruik de opdracht az iot ops upgrade om een bestaand Azure IoT Operations-exemplaar terug te draaien naar een eerdere versie.

In de upgradeopdracht kunt u een onderdeelversie opgeven van maximaal drie secundaire versies die ouder zijn dan de meest recente.

U vindt de ondersteunde onderdeelversies en release-informatie in het azure-iot-operations-enablement.json-bestand dat is opgenomen in een opgegeven Versie van Azure IoT Operations.