Sdílet prostřednictvím


Klonování instance IoT Operations (náhled)

Existující instanci Azure IoT Operations můžete naklonovat a vytvořit novou instanci se stejnou konfigurací a nastavením. Klonování je užitečné pro vytvoření zálohy instance nebo pro nastavení nové instance se stejnou konfigurací pro účely testování nebo vývoje.

Scénáře použití pro klonování zahrnují:

  • Zotavení po havárii: Vytvořte zálohu instance Azure IoT Operations, kterou můžete použít k obnovení instance, pokud dojde k havárii.
  • Testování a vývoj: Nastavte novou instanci operací Azure IoT se stejnou konfigurací jako existující instance pro účely testování nebo vývoje.
  • Migrace: Přesuňte instanci operace Azure IoT do nového clusteru nebo skupiny prostředků naklonováním instance do nového umístění.
  • Škálování: Vytvořte několik instancí vaší instance operací Azure IoT, abyste mohli zpracovávat zvýšené úlohy nebo distribuovat zatížení napříč několika instancemi.

Poznámka:

Funkce klonování je ve verzi Preview a ve vývoji.

Požadavky

  • Instance provozu Azure IoT nasazená do clusteru. Další informace najdete v tématu Nasazení operací Azure IoT.

  • Azure CLI nainstalované na vývojovém počítači. Tento scénář vyžaduje 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 Postup instalace Azure CLI.

  • Rozšíření Azure IoT Operations pro Azure CLI. Klon je v současné době kompatibilní s následujícím rozsahem verzí instance ioT Operations: 1.0.34>=,<1.2.0 K aktualizaci nebo instalaci rozšíření použijte následující příkaz. Nahraďte <VERSION_NUMBER> verzí, která je kompatibilní s vaší instancí.

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

Přehled příkazu Clone

az iot ops clone Pomocí příkazu vytvořte novou instanci operací Azure IoT založenou na existující instanci.

Příkaz clone analyzuje instanci azure IoT Operations a reprodukuje ji způsobem infrastruktury jako kódu prostřednictvím šablon ARM. Výstup klonování můžete použít na jiný připojený cluster, který se označuje jako replikace. Klon můžete také uložit do místního adresáře pro pozdější použití a před použitím v clusteru provést určité změny konfigurace.

Operace klonování se skládá ze tří hlavních komponent: modelu, což je zdrojová instance, cíl, což je cílová instance a šablona. Následující diagram znázorňuje tok klonování. Příkaz clone analyzuje zdrojová instance a replikuje ji prostřednictvím šablony IaC/ARM. Replikovaná definice se použije na jeden nebo více cílových clusterů.

Diagram podmnožiny všech prostředků souvisejících s instancemi ukazuje, jak funguje příkaz klonování pro instance operací Azure IoT.

Klonování modelu

Model je instance, ze které klonujete. Je zdrojem pravdy pro operaci klonování. Pokud chcete model identifikovat, zadejte následující parametry:

  • --name/-n: Název instance modelu.
  • --resource-group/-g: Skupina prostředků, která obsahuje instanci modelu.

Klonování cíle

Cílem je místo, kam chcete replikovat nebo uložit definici klonu. Klon můžete použít na jeden, všechny nebo žádné cíle. Pokud nezadáte žádné cílové možnosti, proces se ukončí po výstupu souhrnu prostředků v oboru. Pokud chcete identifikovat cíl, zadejte jeden z následujících parametrů:

  • --to-cluster-id: Zadejte úplné ID prostředku Azure cílového clusteru, do kterého chcete replikovat naklonovanou instanci. Pokud použijete tuto možnost, klonovací příkaz nasadí verzi operací Azure IoT zadaných v definici klonu do cílového clusteru a potom použije všechny relevantní prostředky k dokončení nasazení. Automatická federace přihlašovacích údajů spravované identity přiřazené uživatelem (UAMI) je v současné době podporována jenom při klonování na cílový cluster.

  • --to-dir: Zadejte cestu k místnímu adresáři pro replikaci definice klonování na disk, kde ji můžete nasadit se stávajícími nástroji pro nasazení ARM s úpravami nebo bez ní. Pokud prověříte definici klonu, uvidíte různé parametrizace, aby se usnadnilo přizpůsobení.

Důležité

Při výběru cílové skupiny prostředků zvažte použití skupiny prostředků, která neobsahuje existující instalaci operací IoT a je oddělená od skupiny prostředků modelu. Ve výchozím nastavení definice klonu zachovává názvy prostředků z instance modelu. Pokud cíl a model sdílejí stejnou skupinu prostředků a změníte vlastní umístění, může dojít ke konfliktům názvů prostředků.

Klonování šablony

Příkaz clone vygeneruje šablonu ARM, která popisuje prostředky, které se mají vytvořit v cíli. Šablona se vygeneruje na základě prostředků v instanci modelu a jejich konfigurace. Zadejte následující volitelné parametry pro přizpůsobení šablony:

Parametry přizpůsobení klonované šablony

K přizpůsobení vygenerované šablony ARM můžete použít následující volitelné parametry:

  • --mode: Určuje způsob uspořádání dílčích nasazení v šabloně.

    • Při režimu nested (výchozí) jsou všechna dílčí nasazení obsažena v kořenovém souboru nasazení.
    • Při linked použití režimu se dílčí nasazení související s prostředky rozdělí a uloží jako samostatné soubory, které jsou pak propojeny kořenovým nasazením. Použijte režim linked, pokud vaše instance obsahuje velký počet zařízení a prostředků, aby se zlepšila škálovatelnost a spravovatelnost. Tento parametr nemusíte zadávat, pokud toto oddělení nevyžadujete pro velká nasazení.
  • --param: Umožňuje přepsat předdefinované výchozí parametry, například locationinstanceName, nebo adrNamespaceId, pomocí formátu key=value. Slouží --help k zobrazení úplného seznamu klíčů.

Klonování instance

Pokud chcete naklonovat instanci, použijte az iot ops clone příkaz s příslušnými parametry k určení zdrojové instance a cílového umístění.

  1. Než začnete, nastavte výchozí předplatné na stejné předplatné, ve které je instance modelu. V opačném případě musíte při každém spuštění příkazu --subscription připojit az iot ops clone.

    az account set -s $MODEL_SUBSCRIPTION_ID
    
  2. Id prostředku clusteru získáte spuštěním příkazu:

    az resource show --name <CLUSTER_NAME> --resource-group <RESOURCE_GROUP> --resource-type "Microsoft.Kubernetes/connectedClusters" --query id --output tsv
    
  3. Pokud chcete naklonovat instanci a replikovat do cílového clusteru připojeného k Arc pomocí výchozích možností, spustit:

    az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> 
    
  4. Chcete-li přizpůsobit replikaci do jiného clusteru, použijte --param a zadejte parametry, které chcete změnit ve formátu key=value. Pokud chcete například změnit umístění naklonované instance, spusťte:

    az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> --param location=eastus
    
  5. Pokud chcete naklonovat instanci na místní disk, zadejte --to-dir pomocí parametru adresář, do kterého chcete definici klonu uložit. Tato možnost vytvoří standardní šablonu ARM, která se bude zpracovávat nebo nasazovat podle vlastního uvážení.

    az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-dir <DIRECTORY>
    

    Návod

    Pokud chcete naklonovat instanci do aktuálního adresáře, spusťte příkaz --to-dir .

  6. Pokud chcete naklonovat a replikovat instanci do cílového clusteru a uložit do souboru ve stejné operaci, spusťte následující příkaz:

    az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> --to-dir <DIRECTORY>
    
  7. Pokud chcete naklonovat instanci do clusteru a současně rozdělit a sériově aplikovat dílčí nasazení související s prostředky, použijte --mode linked. parametr. Tento parametr umožňuje nejvyšší míru škálování, pokud instance modelu obsahuje značný počet prostředků souvisejících s aktivy.

    az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> --mode linked
    
  8. Pokud chcete naklonovat instanci na disk v propojeném režimu, kde je možné nasadit každou propojenou šablonu prostředku nebo profilu koncového bodu prostředku odděleně od kořenové šablony.

    az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-dir . --mode linked
    

Úvahy a omezení

  • Automatická federace identit je aktuálně podporovaná jenom s --to-cluster-id možností.
  • Pravidla synchronizace prostředků nejsou zachycena.
  • Zatímco požadovaná přiřazení role mezi spravovanou identitou systému IoT Operations a registrem cílového schématu jsou zajišťována klonem, žádná jiná přiřazení rolí spravovaných identit systémů nejsou pokryta.
  • Klon je operace na straně cloudu. S clusterem se přímo neinteraguje. Tajné kódy clusteru se synchronizují z cloudu prostřednictvím zabezpečených nastavení, která zahrnují třídy poskytovatelů tajných kódů a cloudové prostředky synchronizace tajných kódů. Pokud má cluster modelu vytvořené prvky, jako jsou objekty configmap, na které odkazuje řešení IoT Operations, je potřeba tyto prvky znovu aplikovat na cílový cluster.