De levenscyclus van een Azure IoT Operations-exemplaar beheren

Gebruik de Azure CLI en Azure Portal om Azure IoT Operations-exemplaren te beheren, te verwijderen of bij te werken.

Vereisten

• Een Azure IoT Operations-exemplaar dat is geïmplementeerd in een cluster. Zie Azure IoT-bewerkingen implementeren voor meer informatie.

• Azure CLI is geïnstalleerd op uw ontwikkelcomputer. Voor dit scenario is Azure CLI versie 2.64.0 of hoger vereist. Gebruik az --version deze optie om uw versie te controleren en az upgrade zo nodig bij te werken. Zie De Azure CLI installeren voor meer informatie.

• De Azure IoT Operations-extensie voor Azure CLI. Gebruik de volgende opdracht om de extensie toe te voegen of bij te werken naar de nieuwste versie:

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

Beheren

Na de implementatie kunt u de Azure CLI en Azure Portal gebruiken om uw Azure IoT Operations-exemplaar weer te geven en te beheren.

Exemplaren weergeven

Azure-portal

1. Zoek en selecteer Azure IoT Operations in Azure Portal.
2. Gebruik de filters om Azure IoT Operations-exemplaren weer te geven op basis van abonnement, resourcegroep en meer.

Azure-CLI

Gebruik de az iot ops list opdracht om alle Azure IoT Operations-exemplaren in uw abonnement of resourcegroep weer te geven.

Met de basisopdracht worden alle exemplaren in uw abonnement geretourneerd.

az iot ops list

Als u de resultaten wilt filteren op resourcegroep, voegt u de --resource-group parameter toe.

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

Exemplaar weergeven

Azure-portal

U kunt uw Azure IoT Operations-exemplaar bekijken in Azure Portal.

1. Ga in Azure Portal naar de resourcegroep die uw Azure IoT Operations-exemplaar bevat of zoek en selecteer Azure IoT Operations.

2. Selecteer de naam van uw Azure IoT Operations-exemplaar.

3. Op de pagina Overzicht van uw exemplaar worden in de tabel Arc-extensies de resources weergegeven die zijn geïmplementeerd in uw cluster.

   

Azure-CLI

Gebruik de az iot ops show opdracht om de eigenschappen van een exemplaar weer te geven.

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

U kunt de az iot ops show opdracht ook gebruiken om de resources weer te geven in uw Azure IoT Operations-implementatie in de Azure CLI. Voeg de --tree vlag toe om een structuurweergave weer te geven van de implementatie die het opgegeven Azure IoT Operations-exemplaar bevat.

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

De structuurweergave van een implementatie ziet eruit als in het volgende voorbeeld:

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

U kunt az iot ops check uitvoeren op uw cluster om de status en configuraties van afzonderlijke Azure IoT Operations-onderdelen te evalueren. De opdracht controleert standaard MQ, maar u kunt de service met --ops-service parameter opgeven.

Exemplaartags en beschrijving bijwerken

Azure-portal

1. Ga in Azure Portal naar de resourcegroep die uw Azure IoT Operations-exemplaar bevat of zoek en selecteer Azure IoT Operations.

2. Selecteer de naam van uw Azure IoT Operations-exemplaar.

3. Selecteer tags toevoegen of bewerken op de pagina Overzicht van uw exemplaar om tags op uw exemplaar te wijzigen.

Azure-CLI

Gebruik de az iot ops update opdracht om de tags en beschrijvingsparameters van uw Azure IoT Operations-exemplaar te bewerken. De waarden in de update opdracht vervangen eventuele bestaande tags of beschrijvingen

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

Als u alle tags op een exemplaar wilt verwijderen, stelt u de parameter tags in op een null-waarde. Voorbeeld:

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

Onderdelen beheren

Elk Azure IoT Operations-exemplaar bevat verschillende onderdelen, zoals de MQTT-broker, connector voor OPC UA en gegevensstromen. Zie de desbetreffende artikelen voor meer informatie over het beheren van deze onderdelen. Als u bijvoorbeeld de MQTT-broker wilt beheren, begint u met het Broker-overzicht.

(Preview) Onderdelen beheren met behulp van Kubernetes-implementatiemanifesten

Over het algemeen maakt Azure IoT Operations gebruik van het Azure Arc-platform om een hybride cloudervaring te bieden waar u de configuratie kunt beheren via Azure Resource Manager (ARM) en front-endhulpprogramma's zoals Azure Portal, Bicep en de Azure CLI.

U kunt echter ook de onderdelen van Azure IoT-bewerkingen beheren met behulp van YAML Kubernetes-implementatiemanifesten. Dit betekent dat u hulpprogramma's kunt gebruiken om kubectl bepaalde onderdelen van Azure IoT Operations te beheren. Deze functie is in preview en heeft enkele beperkingen:

• Alleen sommige onderdelen ondersteunen het gebruik van Kubernetes-implementatiemanifesten. Deze onderdelen zijn de MQTT-broker en gegevensstromen. Andere onderdelen, zoals de connector voor OPC UA- en Akri-services, bieden geen ondersteuning voor deze functie.
• Tenzij Azure IoT-bewerkingen worden geïmplementeerd met resourcesynchronisatie ingeschakeld met behulp az iot ops create --enable-rsyncvan, worden wijzigingen in de resources die gebruikmaken van Kubernetes-implementatiemanifesten niet gesynchroniseerd met Azure. Zie Resourcesynchronisatie voor meer informatie over resourcesynchronisatie.
• Zelfs als resourcesynchronisatie is ingeschakeld, worden gloednieuwe resources die zijn gemaakt met kubernetes-implementatiemanifesten niet gesynchroniseerd met Azure. Alleen wijzigingen in bestaande resources worden gesynchroniseerd.

Verwijderen

Azure CLI en Azure Portal bieden verschillende opties voor het verwijderen van Azure IoT Operations.

Met de stappen in Azure Portal kunt u een Azure IoT Operations-exemplaar verwijderen, maar dit kan geen invloed hebben op de gerelateerde resources in de implementatie. Als u de hele implementatie wilt verwijderen, gebruikt u de Azure CLI.

Azure-portal

1. Ga in Azure Portal naar de resourcegroep die uw Azure IoT Operations-exemplaar bevat of zoek en selecteer Azure IoT Operations.

2. Selecteer de naam van uw Azure IoT Operations-exemplaar.

3. Selecteer Verwijderen op de pagina Overzicht van uw exemplaar.

4. Controleer de lijst met resources die zijn en die niet worden verwijderd als onderdeel van deze bewerking, typ de naam van uw exemplaar en selecteer Verwijderen om te bevestigen.

   

Azure-CLI

Gebruik de opdracht az iot ops delete om de volledige Azure IoT Operations-implementatie uit een cluster te verwijderen. Met delete de opdracht worden de aan Azure IoT Operations gerelateerde resources in het cluster geëvalueerd en wordt een structuurweergave weergegeven van de resources die moeten worden verwijderd. Het cluster moet online zijn wanneer u deze opdracht uitvoert.

De delete opdracht stroomlijnt de herimplementatie van Azure IoT-bewerkingen naar hetzelfde cluster. Hiermee maakt u de create opdracht ongedaan, zodat u kunt uitvoeren create, deleteenzovoort create zonder dat u opnieuw hoeft uit te voeren init.

Met de delete opdracht wordt het volgende verwijderd:

• Het Azure IoT Operations-exemplaar
• Arc-extensies
• Aangepaste locaties
• Resourcesynchronisatieregels
• Resources die u kunt configureren in uw Azure IoT Operations-oplossing, zoals assets, MQTT-broker en gegevensstromen.

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

Als u het exemplaar wilt verwijderen en ook de Afhankelijkheden van Azure IoT-bewerkingen (de uitvoer van init), voegt u de vlag --include-depstoe.

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