Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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 --versionke kontrole vaší verze aaz upgradek 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.0K 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
linkedpouž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žimlinked, 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í.
- Při režimu
--param: Umožňuje přepsat předdefinované výchozí parametry, napříkladlocationinstanceName, neboadrNamespaceId, pomocí formátukey=value. Slouží--helpk 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í.
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
--subscriptionpřipojitaz iot ops clone.az account set -s $MODEL_SUBSCRIPTION_IDId 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 tsvPokud 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>Chcete-li přizpůsobit replikaci do jiného clusteru, použijte
--parama zadejte parametry, které chcete změnit ve formátukey=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=eastusPokud chcete naklonovat instanci na místní disk, zadejte
--to-dirpomocí 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 .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>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 linkedPokud 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-idmož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.