Uppgradera till en ny version

2025-08-21

Lär dig hur du uppgraderar en Azure IoT Operations-distribution till en nyare version.

Förutsättningar

Ett Azure-konto med en aktiv prenumeration. Om du inte har något konto kan du skapa ett kostnadsfritt konto.
Azure CLI version 2.53.0 eller senare. Använd az --version för att kontrollera din version och az upgrade uppdatera om det behövs. Mer information finns i Kom igång med Azure CLI.

Förstå uppgraderingsstöd

Versionsversioner av Azure IoT Operations kan vara förhandsversioner eller allmänt tillgängliga (GA) och du hittar den senaste versionen i dokumentet om Azure IoT Operations-versioner . Azure IoT Operations CLI-tilläggsversionen är kopplad till Azure IoT Operations-versionen, så du måste se till att du har rätt CLI-tilläggsversion installerad för att utföra en uppgradering.

Azure IoT Operations stöder följande uppgraderingsscenarier:

Du kan uppgradera en befintlig Azure IoT Operations-instans till valfri korrigering av samma delversion eller till nästa delversion.
Du kan inte nedgradera mellan versioner. Om du vill flytta till en äldre version avinstallerar du Azure IoT Operations och installerar om den önskade versionen.
Du kan inte uppgradera från någon förhandsversion till en GA-version. Du måste avinstallera Azure IoT Operations och installera om den nya versionen.
Du kan inte uppgradera från någon GA-version till en förhandsversion. Mer information om hur du installerar en förhandsversion finns i Uppgradera till förhandsversion.

Anmärkning

Azure IoT Operations stöder inte liveuppgraderingar. Förvänta dig en viss stilleståndstid under uppgraderingsprocessen.

Uppgradera

Azure IoT Operations stöder uppgradering av instanser till nya GA-versioner när de släpps. Om din Azure IoT Operations-instans är berättigad till en uppgradering kan du använda Azure-portalen eller Azure CLI för att utföra uppgraderingen.

Om den senaste versionen av Azure IoT Operations är i förhandsversion läser du Uppgradera till förhandsversion.

Azure Portal
Azure CLI

Om din Azure IoT Operations-distribution är berättigad till en uppgradering visar Azure-portalen ett uppgraderingsalternativ . Om du inte ser alternativet att uppgradera finns distributionen på den senaste versionen.

I Azure-portalen går du till din Azure IoT Operations-instans.
Välj Uppgradera på sidan Översikt för din instans.
Du måste använda den senaste versionen av Azure IoT Operations CLI-tillägget för att få den senaste versionen av Azure IoT Operations. Om du inte har uppdaterat tillägget som en del av förutsättningarna gör du det nu.
```
az extension add --upgrade --name azure-iot-ops
```
Om du vill uppgradera distributionen till en nyare version men inte den senaste anger du CLI-tilläggsversionen till den som är associerad med dina önskade Azure IoT Operations-versioner i IoT Operations-versioner.
```
az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>
```
Portalen visar Azure CLI-kommandot för att uppgradera din instans, förifyllt med din prenumeration, resursgrupp och instansinformation. Välj kopieringsikonen bredvid CLI-kommandot.
Kör det kopierade az iot ops upgrade kommandot.
När uppgraderingskommandot har slutförts uppdaterar du instansen för att se ändringarna.

Versionsvärdet som visas på instansens översiktssida visar versionen av Azure IoT Operations-instansen. Du kan dock uppmanas att uppgradera om ett nödvändigt Arc-tillägg har en tillgänglig uppgradering. Du kan se att en uppgradering lyckades om uppgraderingsalternativet försvinner från instansöversiktssidan, även om det inte ser ut som om något har ändrats. Du kan kontrollera versionerna av Arc-tilläggen för din Azure IoT Operation-distribution på sidan Tillägg i ditt Arc-aktiverade kluster i Azure-portalen.

Använd kommandot az iot ops upgrade för att uppgradera en befintlig Azure IoT Operations-distribution till en nyare version.

Uppgraderingskommandot utvärderar hela Azure IoT Operations-distributionen för tillgängliga uppdateringar, inklusive arc-tilläggen som är installerade i az iot ops init kommandot och Azure IoT Operations-instansen.

Använd följande steg för att uppgradera distributionen till den senaste versionen:

Lägg till den senaste versionen av Azure IoT Operations CLI-tillägget.
```
az extension add --upgrade --name azure-iot-ops
```

Kör az iot ops upgrade

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

CLI matar ut en tabell med de komponenter som har tillgängliga uppgraderingar. Ange Y för att fortsätta med uppgraderingen.

Om du vill uppgradera till en specifik version av Azure IoT Operations som inte är den senaste kan du köra az iot ops get-versions eller referera till IoT Operations-versioner för att hitta den CLI-tilläggsversion som är associerad med den Azure IoT Operations-version som du vill använda. Hämta versionsnumret och kör följande kommando för att uppgradera till den versionen:

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

Uppgradera till förhandsversion

Ibland är den senaste versionen av Azure IoT Operations i förhandsversion. Kontrollera Azure IoT Operations-versionerna för att se den senaste versionen. Under förhandsversioner blockeras versionsuppgradering och du måste avinstallera Azure IoT Operations och installera om förhandsversionen.

Du kan bara installera en förhandsversion med hjälp av Azure CLI.

Om du har en befintlig Azure IoT Operations-instans måste du avinstallera Azure IoT Operations för att göra en ny distribution.
Lägg till den senaste versionen av Azure IoT Operations CLI-tillägget med --allow-preview flaggan .
```
az extension add --upgrade --name azure-iot-ops --allow-preview
```

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

Uppgraderingsöverväganden för MQTT-koordinator

För att säkerställa noll dataförlust och hög tillgänglighet under distributionsuppgraderingar implementerar MQTT-brokern gradvisa uppdateringar i MQTT-brokerpoddarna. Hälsohanterarens pod samordnar en inkrementell uppgraderingsprocess för MQTT-broker-poddarna för att säkerställa att:

Aktiva klientanslutningar förblir oavbrutna.
Alla meddelanden under flygning bevaras.
Data som lagras på disken migreras korrekt mellan versioner.

Om ett fel inträffar under uppgraderingsprocessen startar hälsohanterarens podd automatiskt om uppgraderingsprocessen samtidigt som ingen dataförlust eller anslutning säkerställs.

Löpande uppdateringar kan bara ske om MQTT-mäklaren distribueras med två eller fler backend-repliker. MQTT-brokeruppgraderingar stöds inte för enkel-replik distribution. När du distribuerar Azure IoT Operations anger du antalet serverdelsrepliker som ska skapas i kommandot az iot ops create med parametern --broker-backend-rf .

Versioner som stöds

Microsoft har stöd för tre allmänt tillgängliga versioner av Azure IoT Operations när som helst: den senaste versionen och de två tidigare delversionerna. Dessutom är förhandsversioner tillgängliga för testning av nya funktioner.

För närvarande är Azure-support tillgängligt för följande versioner:

Utgåva	Typ	Aktuell patch utgåva (YYMM)	Ström CLI-version	Versionsmeddelanden
1.2.x	Preview	1.2.72 (2509)	2.0.0b3 (förhandsversion)	Viktig information
1.1.x	GA	1.1.59 (2506)	1.7.0	Viktig information
1.0.x	GA	1.0.34 (2503)	1.3.0	Viktig information

Mer information om uppgraderingar mellan versioner finns i Uppgradera till en ny version.

Viktigt!

Tidigare delversioner får inte säkerhetskorrigeringar. Uppgradera till den senaste versionen för att hämta de senaste säkerhetsuppdateringarna och funktionerna.

Varning

Använd inte förhandsversioner i produktionsmiljöer.

Om du vill verifiera din aktuella version går du till översiktssidan för din Azure IoT Operations-instans i Azure-portalen eller använder kommandot Azure IoT Operations CLI az iot ops instance show .

Feedback

Var den här sidan till hjälp?