Uaktualnianie do nowej wersji

Dowiedz się, jak uaktualnić wdrożenie operacji usługi Azure IoT do nowszej wersji.

Wymagania wstępne

• Konto Azure z aktywną subskrypcją. Jeśli nie masz konta, możesz utworzyć bezpłatne konto.
• Interfejs wiersza polecenia platformy Azure w wersji 2.53.0 lub nowszej. Użyj az --version aby sprawdzić swoją wersję i az upgrade aby zaktualizować, jeśli to konieczne. Aby uzyskać więcej informacji, zobacz Get started with Azure CLI.

Zrozum wsparcie dla aktualizacji

Wersje wydań operacji Azure IoT mogą być dostępne jako wersja preview lub jako wersja ogólnie dostępna (GA). Najnowszą wersję można znaleźć w dokumencie Wersje operacji Azure IoT. Wersja rozszerzenia interfejsu wiersza polecenia operacji usługi Azure IoT jest powiązana z wersją operacji usługi Azure IoT, dlatego musisz upewnić się, że masz zainstalowaną poprawną wersję rozszerzenia interfejsu wiersza polecenia w celu przeprowadzenia uaktualnienia.

Operacje usługi Azure IoT obsługują następujące scenariusze uaktualniania:

• Możesz zaktualizować istniejącą instancję Azure IoT Operations do dowolnego uaktualnienia tej samej pomniejszej wersji lub do następnej pomniejszej wersji.
• Nie można obniżyć wersji. Aby przejść do starszej wersji, odinstaluj operacje usługi Azure IoT i ponownie zainstaluj odpowiednią wersję.
• Nie można uaktualnić wersji zapoznawczej do wersji ogólnodostępnej. Należy odinstalować operacje usługi Azure IoT i ponownie zainstalować nową wersję.
• Nie można uaktualnić wersji GA do wersji zapoznawczej. Aby uzyskać więcej informacji na temat sposobu instalowania wersji zapoznawczej, zobacz Uaktualnianie do wersji zapoznawczej.

Uwaga / Notatka

Operacje usługi Azure IoT nie obsługują uaktualnień na żywo. Spodziewaj się przestoju podczas procesu uaktualniania.

Aktualizacja

Azure IoT Operations wspiera aktualizację instancji do nowych wersji GA, gdy są one wydawane. Jeśli twoje wystąpienie Azure IoT Operations kwalifikuje się do uaktualnienia, możesz użyć portalu Azure lub Azure CLI do przeprowadzenia uaktualnienia.

Jeśli najnowsza wersja operacji usługi Azure IoT jest dostępna w wersji zapoznawczej, zobacz Uaktualnianie do wersji zapoznawczej.

Portal Azure

Jeśli Twoje wdrożenie usługi Azure IoT Operations kwalifikuje się do aktualizacji, portal Azure wyświetli opcję Upgrade. Jeśli nie widzisz opcji aktualizacji, oznacza to, że twoje wdrożenie jest na najnowszej wersji.

1. W portalu Azure nawiguj do swojej instancji Azure IoT Operations.

2. Wybierz Uaktualnij na stronie Przegląd swojego wystąpienia.

   

3. Musisz użyć najnowszej wersji rozszerzenia Azure IoT Operations CLI, aby uzyskać najnowszą wersję Azure IoT Operations. Jeśli nie zaktualizowałeś rozszerzenia w ramach wymagań wstępnych, zrób to teraz.

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

   Jeśli chcesz uaktualnić wdrożenie do nowszej wersji, ale nie najnowszej, ustaw wersję rozszerzenia CLI na wersję związaną z wybranymi wersjami operacji Azure IoT w IoT Operations versions.

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

4. Portal przedstawia polecenie Azure CLI do aktualizacji instancji, wstępnie wypełnione danymi o subskrypcji, grupie zasobów i szczegółach instancji. Wybierz ikonę kopiowania obok polecenia CLI.

5. Uruchom skopiowane polecenie az iot ops upgrade.

6. Po pomyślnym zakończeniu polecenia aktualizacji, odśwież swoją instancję, aby zobaczyć zmiany.

Wartość Version wyświetlana na stronie przeglądu instancji odzwierciedla wersję instancji Azure IoT Operations. Możesz jednak zostać poproszony o aktualizację, jeśli dostępna jest aktualizacja wymaganego rozszerzenia Arc. Możesz stwierdzić, że aktualizacja się powiodła, jeśli opcja Aktualizuj znika ze strony przeglądowej instancji, nawet jeśli na pierwszy rzut oka nic się nie zmieniło. Możesz sprawdzić wersje rozszerzeń Arc dla wdrożenia operacji Azure IoT na stronie Rozszerzenia w klastra obsługiwanym przez Arc w portalu Azure.

Interfejs wiersza polecenia platformy Azure

Użyj polecenia az iot ops upgrade, aby zaktualizować istniejącą wdrożoną wersję Azure IoT Operations do nowszej wersji.

Polecenie upgrade ocenia całe wdrożenie Azure IoT Operations pod kątem dostępnych aktualizacji, w tym rozszerzenia arc, które są zainstalowane w poleceniu az iot ops init i instancji Azure IoT Operations.

Aby uaktualnić swoją instalację do najnowszej wersji, wykonaj następujące kroki:

1. Dodaj najnowszą wersję rozszerzenia CLI Azure IoT Operations.

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

2. Uruchom az iot ops upgrade

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

3. Interfejs CLI wyświetla tabelę komponentów, które mają dostępne aktualizacje. Wprowadź Y, aby kontynuować aktualizację.

Jeśli chcesz przeprowadzić uaktualnienie do określonej wersji Azure IoT Operations, która nie jest najnowsza, możesz uruchomić az iot ops get-versions lub odwołać się do wersji Azure IoT Operations, aby znaleźć wersję rozszerzenia CLI skojarzoną z odpowiednią wersją Azure IoT Operations. Pobierz numer wersji i uruchom następujące polecenie, aby przeprowadzić uaktualnienie do tej wersji:

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

Uaktualnianie do wersji zapoznawczej

Czasami najnowsza wersja operacji usługi Azure IoT jest dostępna w wersji zapoznawczej. Sprawdź wersje operacji usługi Azure IoT, aby zobaczyć najnowszą wersję. W wersjach zapoznawczych uaktualnienie wersji jest zablokowane i należy odinstalować operacje usługi Azure IoT i ponownie zainstalować wersję zapoznawcza.

Wersję zapoznawcza można zainstalować tylko przy użyciu interfejsu wiersza polecenia platformy Azure.

1. Jeśli masz istniejące wystąpienie Azure IoT Operations, musisz odinstalować Azure IoT Operations, aby wykonać nowe wdrożenie.

2. Dodaj najnowszą wersję rozszerzenia CLI do operacji Azure IoT z flagą --allow-preview.

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

Jeśli chcesz przeprowadzić uaktualnienie do określonej wersji Azure IoT Operations, która nie jest najnowsza, możesz uruchomić az iot ops get-versions lub odwołać się do wersji Azure IoT Operations, aby znaleźć wersję rozszerzenia CLI skojarzoną z odpowiednią wersją Azure IoT Operations. Pobierz numer wersji i uruchom następujące polecenie, aby przeprowadzić uaktualnienie do tej wersji:

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

Rozważania dotyczące aktualizacji brokera MQTT

Aby zapewnić zerową utratę danych i wysoką dostępność podczas aktualizacji wdrożenia, broker MQTT przeprowadza aktualizacje stopniowe w zasobnikach brokera MQTT. Moduł zarządzania zdrowiem koordynuje proces stopniowej aktualizacji modułów MQTT brokerów, aby zapewnić, że:

• Aktywne połączenia klientów pozostają nieprzerwane.
• Wszystkie wiadomości w trakcie przekazu są zachowane.
• Dane przechowywane na dysku są prawidłowo migrowane między wersjami.

Jeśli wystąpi awaria podczas procesu aktualizacji, pod menedżera stanu zdrowia automatycznie ponownie uruchamia proces aktualizacji, zapewniając brak utraty danych ani łączności.

Aktualizacje stopniowe mogą wystąpić tylko w przypadku wdrożenia brokera MQTT z co najmniej dwiema replikami zaplecza. Aktualizacje brokera MQTT nie są obsługiwane dla wdrożeń z pojedynczą repliką. Podczas wdrażania operacji usługi Azure IoT należy określić liczbę replik zaplecza do utworzenia w poleceniu az iot ops create za pomocą parametru --broker-backend-rf .

Obsługiwane wersje

Firma Microsoft obsługuje w dowolnym momencie trzy ogólnie dostępne wersje operacji usługi Azure IoT: najnowszą wersję i dwie poprzednie wersje pomocnicze. Ponadto wersje wersji zapoznawczej są dostępne do testowania nowych funkcji.

Obecnie obsługa platformy Azure jest dostępna dla następujących wersji:

wersja	Typ	Bieżąca poprawka wydanie (YYMM)	Aktualny Wersja CLI	Informacje o wydaniu
1.2.x	ogólna dostępność	1.2.112 (2510)	2.0.1	Uwagi do wydania
1.1.x	ogólna dostępność	1.1.59 (2506)	1.7.0	Uwagi do wydania
1.0.x	ogólna dostępność	1.0.34 (2503)	1.3.0	Uwagi do wydania

Aby dowiedzieć się więcej na temat uaktualnień między wersjami, zobacz Uaktualnianie do nowej wersji.

Ważne

Poprzednie wersje pomocnicze nie otrzymują poprawek zabezpieczeń. Uaktualnij do najnowszej wersji, aby uzyskać najnowsze aktualizacje zabezpieczeń i funkcje.

Ostrzeżenie

Nie używaj wersji zapoznawczych w środowiskach produkcyjnych.

Aby zweryfikować bieżącą wersję, przejdź do strony przeglądu wystąpienia Operacji Azure IoT w portalu Azure lub użyj polecenia az iot ops instance show w interfejsie wiersza poleceń Operacji Azure IoT.