Hantera livscykeln för en Azure IoT Operations-instans

Använd Azure CLI och Azure Portal för att hantera, avinstallera eller uppdatera Azure IoT Operations-instanser.

Förutsättningar

• En Azure IoT Operations-instans som 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.64.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. Använd följande kommando för att lägga till tillägget eller uppdatera det till den senaste versionen:

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

Hantera

Efter distributionen kan du använda Azure CLI och Azure Portal för att visa och hantera din Azure IoT Operations-instans.

Lista instanser

Azure-portalen

1. I Azure Portal söker du efter och väljer Azure IoT-åtgärder.
2. Använd filtren för att visa Azure IoT Operations-instanser baserat på prenumeration, resursgrupp med mera.

Azure CLI

az iot ops list Använd kommandot för att se alla Azure IoT Operations-instanser i din prenumeration eller resursgrupp.

Det grundläggande kommandot returnerar alla instanser i din prenumeration.

az iot ops list

Om du vill filtrera resultatet efter resursgrupp lägger du till parametern --resource-group .

az iot ops list --resource-group <RESOURCE_GROUP>

Visa instans

Azure-portalen

Du kan visa din Azure IoT Operations-instans i Azure Portal.

1. I Azure Portal går du till resursgruppen som innehåller din Azure IoT Operations-instans eller söker efter och väljer Azure IoT Operations.

2. Välj namnet på din Azure IoT Operations-instans.

3. På sidan Översikt för din instans visar tabellen Arc-tillägg de resurser som har distribuerats till klustret.

   

Azure CLI

az iot ops show Använd kommandot för att visa egenskaperna för en instans.

az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>

Du kan också använda az iot ops show kommandot för att visa resurserna i din Azure IoT Operations-distribution i Azure CLI. --tree Lägg till flaggan för att visa en trädvy över distributionen som innehåller den angivna Azure IoT Operations-instansen.

az iot ops show --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --tree

Trädvyn för en distribution ser ut som i följande exempel:

MyCluster
├── extensions
│   ├── akvsecretsprovider
│   ├── azure-iot-operations-ltwgs
│   └── azure-iot-operations-platform-ltwgs
└── customLocations
    └── MyCluster-cl
        ├── resourceSyncRules
        └── resources
            ├── MyCluster-ops-init-instance
            └── MyCluster-observability

Du kan köra az iot ops check på klustret för att utvärdera hälsotillstånd och konfigurationer för enskilda Azure IoT Operations-komponenter. Som standard kontrollerar kommandot MQ, men du kan ange tjänsten med --ops-service parametern .

Uppdatera instanstaggar och beskrivning

Azure-portalen

1. I Azure Portal går du till resursgruppen som innehåller din Azure IoT Operations-instans eller söker efter och väljer Azure IoT Operations.

2. Välj namnet på din Azure IoT Operations-instans.

3. På sidan Översikt för din instans väljer du Lägg till taggar eller redigera för att ändra taggar på din instans.

Azure CLI

az iot ops update Använd kommandot för att redigera taggarna och beskrivningsparametrarna för din Azure IoT Operations-instans. Värdena som anges i update kommandot ersätter alla befintliga taggar eller beskrivningar

az iot ops update --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --desc "<INSTANCE_DESCRIPTION>" --tags <TAG_NAME>=<TAG-VALUE> <TAG_NAME>=<TAG-VALUE>

Om du vill ta bort alla taggar på en instans anger du parametern taggar till ett null-värde. Till exempel:

az iot ops update --name <INSTANCE_NAME> --resource-group --tags ""

Hantera komponenter

Varje Azure IoT Operations-instans innehåller flera komponenter, till exempel MQTT-koordinatorn, anslutningsappen för OPC UA och dataflöden. Mer information om hur du hanterar dessa komponenter finns i deras respektive artiklar. Om du till exempel vill hantera MQTT-koordinatorn börjar du med Översikt över broker.

(Förhandsversion) Hantera komponenter med kubernetes-distributionsmanifest

I allmänhet använder Azure IoT Operations Azure Arc-plattformen för att tillhandahålla en hybridmolnupplevelse där du kan hantera konfigurationen via Azure Resource Manager (ARM) och klientdelsverktyg som Azure Portal, Bicep och Azure CLI.

Du kan dock också hantera komponenterna i Azure IoT Operations med yaml Kubernetes-distributionsmanifest. Det innebär att du kan använda verktyg som kubectl för att hantera vissa komponenter i Azure IoT Operations. Den här funktionen är i förhandsversion och har vissa begränsningar:

• Endast vissa komponenter stöder användning av Kubernetes-distributionsmanifest. Dessa komponenter är MQTT-koordinatorn och dataflödena. Andra komponenter som anslutningsprogrammet för OPC UA- och Akri-tjänster stöder inte den här funktionen.
• Om inte Azure IoT Operations distribueras med resurssynkronisering aktiverat med hjälp av az iot ops create --enable-rsyncsynkroniseras inte ändringar som görs i resurserna med kubernetes-distributionsmanifest till Azure. Mer information om resurssynkronisering finns i Resurssynkronisering.
• Även om resurssynkronisering är aktiverat synkroniseras inte helt nya resurser som skapats med kubernetes-distributionsmanifest till Azure. Endast ändringar av befintliga resurser synkroniseras.

Avinstallera

Azure CLI och Azure Portal erbjuder olika alternativ för att avinstallera Azure IoT-åtgärder.

De Azure Portal stegen kan ta bort en Azure IoT Operations-instans, men kan inte påverka relaterade resurser i distributionen. Om du vill ta bort hela distributionen använder du Azure CLI.

Azure-portalen

1. I Azure Portal går du till resursgruppen som innehåller din Azure IoT Operations-instans eller söker efter och väljer Azure IoT Operations.

2. Välj namnet på din Azure IoT Operations-instans.

3. På sidan Översikt för din instans väljer du Ta bort.

4. Granska listan över resurser som tas bort och som inte tas bort som en del av den här åtgärden, skriv sedan namnet på din instans och välj Ta bort för att bekräfta.

   

Azure CLI

Använd kommandot az iot ops delete för att ta bort hela Azure IoT Operations-distributionen från ett kluster. Kommandot delete utvärderar Azure IoT Operations-relaterade resurser i klustret och visar en trädvy över de resurser som ska tas bort. Klustret bör vara online när du kör det här kommandot.

Kommandot delete effektiviserar omdistributionen av Azure IoT-åtgärder till samma kluster. Kommandot ångras create så att du kan köra create, delete, create igen och så vidare utan att behöva köra om init.

Kommandot delete tar bort:

• Azure IoT Operations-instansen
• Arc-tillägg
• Anpassade platser
• Regler för resurssynkronisering
• Resurser som du kan konfigurera i din Azure IoT Operations-lösning, till exempel tillgångar, MQTT-mäklare och dataflöden.

az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>

Om du vill ta bort instansen och även ta bort Azure IoT Operations-beroenden (utdata initfrån ) lägger du till flaggan --include-deps.

az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps