Klona en IoT Operations-instans (förhandsversion)

Du kan klona en befintlig Azure IoT Operations-instans för att skapa en ny instans med samma konfiguration och inställningar. Kloning är användbart för att skapa en säkerhetskopia av din instans eller för att konfigurera en ny instans med samma konfiguration för testning eller utveckling.

Exempel på användningsfall för kloning:

• Haveriberedskap: Skapa en säkerhetskopia av din Azure IoT Operations-instans som kan användas för att återställa instansen om det uppstår en katastrof.
• Testning och utveckling: Konfigurera en ny Azure IoT Operations-instans med samma konfiguration som en befintlig instans för testning eller utveckling.
• Migrering: Flytta din Azure IoT Operations-instans till ett nytt kluster eller en ny resursgrupp genom att klona instansen till den nya platsen.
• Skalning: Skapa flera instanser av din Azure IoT Operations-instans för att hantera ökad arbetsbelastning eller för att distribuera belastningen över flera instanser.

Förutsättningar

• En Azure IoT Operations-instans som har distribuerats till ett kluster. Mer information finns i Distribuera Azure IoT-åtgärder.

• Azure CLI installerat på utvecklingsdatorn. Det här scenariot kräver 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 Installera Azure CLI.

• Azure IoT Operations-tillägget för Azure CLI. Klon är för närvarande kompatibelt med följande versionsintervall för IoT Operations-instansen: 1.0.34>=,<1.2.0. Använd följande kommando för att uppdatera eller installera tillägget. Ersätt <VERSION_NUMBER> med en version som är kompatibel med din instans.

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

Översikt över klonkommando

az iot ops clone Använd kommandot för att skapa en ny Azure IoT Operations-instans baserat på en befintlig.

Kommandot clone analyserar en Azure IoT Operations-instans och återskapar den på ett infrastruktur-som-kod-sätt via ARM-mallar. Du kan använda utdata från klon på ett annat anslutet kluster, som kallas replikering. Du kan också spara klonen i en lokal katalog för senare användning och utföra vissa konfigurationsändringar innan du tillämpar den på ett kluster.

Kloningsåtgärden består av tre huvudkomponenter: modellen, som är källinstansen, målet, som är målinstansen och mallen. Följande diagram illustrerar klonflödet. Kommandot clone analyserar källinstansen och replikerar den via IaC/ARM-mallen. Den replikerade definitionen tillämpas på ett eller flera målkluster.

Klona modell

Modellen är den instans som du klonar från. Det är källan till sanningen för kloningsåtgärden. Ange följande parametrar för att identifiera modellen:

• --name/-n: Modellinstansens namn.
• --resource-group/-g: Den resursgrupp som innehåller modellinstansen.

Klona mål

Målet är där du vill replikera eller spara klondefinitionen. Du kan använda en klon på ett, alla eller inga mål. Om du inte anger några målalternativ avslutas processen när du har matat ut en sammanfattning av resurser i omfånget. Ange någon av följande parametrar för att identifiera målet:

• --to-cluster-id: Ange det fullständiga Azure-resurs-ID:t för målklustret där du vill replikera den klonade instansen. När du använder det här alternativet distribuerar klonkommandot den version av Azure IoT-åtgärder som anges i klondefinitionen till målklustret och tillämpar sedan alla relevanta resurser för att slutföra distributionen. Automatisk federation av användartilldelade autentiseringsuppgifter för hanterad identitet (UAMI) stöds för närvarande endast vid kloning till ett klustermål.

• --to-dir: Ange en lokal katalogsökväg för att replikera klondefinitionen till disken, där den kan distribueras med befintliga ARM-distributionsverktyg med eller utan ändringar. Om du inspekterar klondefinitionen ser du olika parameteriseringar i spelet för att underlätta vissa anpassningar.

Klona mall

Klonkommandot genererar en ARM-mall som beskriver de resurser som ska skapas i målet. Mallen genereras baserat på resurserna i modellinstansen och deras konfiguration. Ange följande valfria parametrar för att anpassa mallen:

Anpassningsparametrar för klonmallar

Du kan använda följande valfria parametrar för att anpassa den genererade ARM-mallen:

• --mode: Anger hur underdistributioner organiseras i mallen.

  • När nested läget används (standard) är alla underdistributioner fristående i rotdistributionsfilen.
  • När linked läget används delas tillgångsrelaterade underdistributioner upp och lagras som separata filer, som sedan länkas av rotdistributionen. Använd linked läge om din instans innehåller ett stort antal namnområdesenheter, namnområdestillgångar, rottillgångar och tillgångsslutpunktsprofiler för att förbättra skalbarheten och hanterbarheten. Du behöver inte ange den här parametern om du inte behöver den här separationen för stora distributioner.

• --param: Gör att du kan åsidosätta inbyggda standardparametrar, till exempel location, instanceNameeller adrNamespaceId, med formatet key=value. Använd --help för att visa den fullständiga listan med nycklar.

Klona en instans

Om du vill klona en instans använder du az iot ops clone kommandot med lämpliga parametrar för att ange källinstansen och målplatsen.

1. Innan du börjar anger du standardprenumerationen till samma prenumeration som modellinstansen finns i. Annars måste du lägga --subscription till varje gång du kör ett az iot ops clone kommando.

   az account set -s $MODEL_SUBSCRIPTION_ID
   

2. Kör kommandot för att hämta ditt klusterresurs-ID:

   az resource show --name <CLUSTER_NAME> --resource-group <RESOURCE_GROUP> --resource-type "Microsoft.Kubernetes/connectedClusters" --query id --output tsv
   

3. Om du vill klona en instans och replikera till ett målbågsanslutet kluster med standardalternativ kör du:

   az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> 
   

4. Om du vill anpassa replikeringen till ett annat kluster använder --param du och anger de parametrar som du vill ändra i formatet key=value. Om du till exempel vill ändra platsen för den klonade instansen kör du:

   az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> --param location=eastus
   

5. Om du vill klona en instans till en lokal disk använder du parametern --to-dir för att ange den katalog där du vill spara klondefinitionen. Det här alternativet skapar en ARM-standardmall som ska manipuleras eller distribueras efter eget gottfinnande.

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

   Tips/Råd

   Om du vill klona en instans till den aktuella katalogen kör du --to-dir .

6. Om du vill klona och replikera en instans till ett målkluster och spara till filen i samma åtgärd kör du:

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

7. Om du vill klona en instans till ett kluster, men dela upp och seriellt tillämpa tillgångsrelaterade underdistributioner, använder du --mode linked. Parametern erbjuder den högsta skalningsgraden när modellinstansen innehåller ett stort antal tillgångsrelaterade resurser.

   az iot ops clone --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --to-cluster-id <CLUSTER_ID> --mode linked
   

8. För att klona en instans till disk i ett länkat läge, kan varje länkad tillgång och/eller mall för tillgångsslutpunktsprofil distribueras separat från rotmallen.

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

Överväganden och begränsningar

• Automatisk identitetsfederation stöds för närvarande endast med --to-cluster-id alternativet .
• Resurssynkroniseringsregler samlas inte in.
• Även om den nödvändiga rolltilldelningen mellan IoT Operations-systemets hanterade identitet och målschemaregistret hanteras av klon, omfattas inte andra systemhanterade identitetsrolltilldelningar.
• Kloning är en åtgärd på molnsidan. Klustret interageras inte direkt med. Klusterhemligheter synkroniseras från molnet via säkra inställningar, som omfattar hemliga providerklasser och molnresurser för hemlig synkronisering. Om modellklustret har användarskapade element, till exempel konfigurationskartor som refereras till i modellens IoT Operations-lösning, måste dessa element tillämpas på nytt mot målklustret.