Sdílet prostřednictvím

Upgrade na novou verzi

Zjistěte, jak upgradovat nasazení azure IoT Operations na novější verzi.

Požadavky

  • Účet Azure s aktivním předplatným. Pokud účet nemáte, můžete si vytvořit bezplatný účet.
  • Azure CLI verze 2.53.0 nebo vyšší Použijte az --version ke kontrole vaší verze a az upgrade k aktualizaci v případě potřeby. Další informace najdete v tématu Začínáme s Azure CLI.

Vysvětlení podpory upgradu

Verze provozní verze Azure IoT můžou být verze Preview nebo obecně dostupné (GA), nejnovější verzi najdete v dokumentu o verzích operací Azure IoT . Verze rozšíření Azure IoT Operations CLI je svázaná s verzí Azure IoT Operations, takže je potřeba zajistit, abyste měli nainstalovanou správnou verzi rozšíření rozhraní příkazového řádku, abyste mohli provést upgrade.

Operace Azure IoT podporují následující scénáře upgradu:

  • Existující instanci Azure IoT Operations můžete upgradovat na jakoukoli opravu stejné podverze nebo na další menší verzi.
  • Mezi verzemi nejde downgradovat. Pokud chcete přejít na starší verzi, odinstalujte operace Azure IoT a přeinstalujte požadovanou verzi.
  • Nemůžete upgradovat z žádné verze Preview na verzi GA. Musíte odinstalovat operace Azure IoT a přeinstalovat novou verzi.
  • Z žádné verze GA nemůžete upgradovat na verzi Preview. Další informace o instalaci verze Preview najdete v tématu Upgrade na verzi Preview.

Poznámka:

Operace Azure IoT nepodporují živé upgrady. Během procesu upgradu prosím počítejte s určitým výpadkem.

Aktualizace

Operace Azure IoT podporují upgrade instancí na nové verze GA při jejich vydání. Pokud má vaše instance Azure IoT Operations nárok na upgrade, můžete k provedení upgradu použít Azure Portal nebo Azure CLI.

Pokud je nejnovější verze operací Azure IoT ve verzi Preview, přečtěte si téma Upgrade na verzi Preview.

Pokud vaše nasazení operací Azure IoT má nárok na upgrade, zobrazí se na webu Azure Portal možnost Upgrade . Pokud možnost upgradu nevidíte, nasazení je na nejnovější verzi.

  1. Na webu Azure Portal přejděte k vaší instanci azure IoT Operations.

  2. Na stránce Přehled vaší instance vyberte Upgradovat.

    Snímek obrazovky znázorňující tlačítko upgradu povolené na webu Azure Portal

  3. Abyste získali nejnovější verzi azure IoT Operations CLI, musíte použít nejnovější verzi rozšíření Azure IoT Operations CLI. Pokud jste rozšíření neaktualizovali jako součást předpokladů, udělejte to nyní.

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

    Nebo pokud chcete upgradovat nasazení na novější verzi, ale ne na nejnovější verzi, nastavte verzi rozšíření rozhraní příkazového řádku na verzi přidruženou k požadovaným verzím operací Azure IoT v operačních verzích IoT.

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

  4. Na portálu se zobrazí příkaz Azure CLI pro upgrade vaší instance, předem vyplněný podrobnostmi o předplatném, skupině prostředků a instanci. Vyberte ikonu kopírování vedle příkazu rozhraní příkazového řádku.

  5. Spusťte zkopírovaný az iot ops upgrade příkaz.

  6. Po úspěšném dokončení příkazu pro upgrade aktualizujte instanci, aby se změny zobrazily.

Hodnota verze zobrazená na stránce přehledu vaší instance odráží verzi instance Azure IoT Operations. Pokud má požadované rozšíření Arc dostupný upgrade, může se však zobrazit výzva k upgradu. Můžete zjistit, že upgrade byl úspěšný, pokud možnost Upgrade zmizí ze stránky přehledu instance, i když nevypadá jako nic jiného. Verze rozšíření Arc pro nasazení operace Azure IoT můžete zkontrolovat na stránce Rozšíření vašeho clusteru s podporou Arc na webu Azure Portal.

Upgrade na verzi Preview

Někdy je nejnovější verze operací Azure IoT ve verzi Preview. Zkontrolujte verze operací Azure IoT a podívejte se na nejnovější verzi. Během verzí Preview se upgrade verzí zablokuje a potřebujete odinstalovat operace Azure IoT a přeinstalovat verzi Preview.

Verzi Preview můžete nainstalovat jenom pomocí Azure CLI.

  1. Pokud máte existující instanci Azure IoT Operations, je potřeba odinstalovat operace Azure IoT , abyste mohli provést nové nasazení.

  2. Přidejte nejnovější verzi rozšíření Azure IoT Operations CLI s příznakem --allow-preview .

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

Pokud chcete upgradovat na konkrétní verzi operací Azure IoT, která není nejnovější, můžete spouštět az iot ops get-versions nebo odkazovat na verze operací IoT a najít verzi rozšíření rozhraní příkazového řádku přidruženou k požadované verzi operace Azure IoT. Získejte číslo verze a spuštěním následujícího příkazu upgradujte na danou verzi:

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

Důležité informace o upgradu zprostředkovatele MQTT

Aby se zajistila nulová ztráta dat a vysoká dostupnost během upgradu nasazení, zprostředkovatel MQTT implementuje kumulativní aktualizace napříč pody zprostředkovatele MQTT. Pod správce zdravotního stavu koordinuje přírůstkový upgrade podů zprostředkovatele MQTT, aby se zajistilo, že:

  • Aktivní klientská připojení zůstávají nepřerušovaná.
  • Všechny zprávy během letu se zachovají.
  • Data uložená na disku se mezi verzemi správně migrují.

Pokud během procesu upgradu dojde k selhání, pod správce stavu automaticky restartuje proces upgradu a zároveň zajistí, aby nedošlo ke ztrátě dat nebo připojení.

K kumulativním aktualizacím může dojít pouze v případě, že je zprostředkovatel MQTT nasazen se dvěma nebo více back-endovými replikami. Upgrady zprostředkovatele MQTT nejsou podporovány pro nasazení s jednou replikou. Při nasazování operací Azure IoT zadáte počet replik back-endu, které se mají vytvořit v příkazu az iot ops create s parametrem --broker-backend-rf .

Podporované verze

Microsoft podporuje tři obecně dostupné (GA) verze operací Azure IoT souběžně: nejnovější verzi a dvě předchozí starší verze. Kromě toho jsou k dispozici verze Preview pro testování nových funkcí.

V současné době je k dispozici podpora Azure pro následující verze:

Version Typ Aktuální oprava
vydání (YYMM)		 Současný
Verze rozhraní příkazového řádku		 Poznámky k vydání
1.2.x GA 1.2.112 (2510) 2.0.1 Poznámky k vydání
1.1.x GA 1.1.59 (2506) 1.7.0 Poznámky k vydání
1.0.x GA 1.0.34 (2503) 1.3.0 Poznámky k vydání

Další informace o upgradech mezi verzemi najdete v tématu Upgrade na novou verzi.

Důležité

Starší verze nedostávají zabezpečovací opravy. Upgradujte na nejnovější verzi, abyste získali nejnovější aktualizace a funkce zabezpečení.

Výstraha

Nepoužívejte verze Preview v produkčních prostředích.

Pokud chcete ověřit aktuální verzi, přejděte na stránku přehledu vaší instance azure IoT Operations na webu Azure Portal nebo použijte příkaz Azure IoT Operations CLI az iot ops instance show .

  • Last updated on