Gestire il ciclo di vita di un'istanza di Azure IoT Operations

Usare l'interfaccia della riga di comando di Azure e portale di Azure per gestire, disinstallare o aggiornare le istanze di Operazioni IoT di Azure.

Prerequisiti

• Un'istanza di Azure IoT Operations distribuita in un cluster. Per altre informazioni, vedere Distribuire le operazioni di Azure IoT.

• Interfaccia della riga di comando di Azure installata nel computer di sviluppo. Questo scenario richiede l'interfaccia della riga di comando di Azure versione 2.64.0 o successiva. Usare az --version per controllare la versione e az upgrade per aggiornare, se necessario. Per altre informazioni, vedere Installare l'interfaccia della riga di comando di Azure.

• Estensione Operazioni di Azure IoT per l'interfaccia della riga di comando di Azure. Usare il comando seguente per aggiungere l'estensione o aggiornarla alla versione più recente:

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

Gestione

Dopo la distribuzione, è possibile usare l'interfaccia della riga di comando di Azure e il portale di Azure per visualizzare e gestire l'istanza di Operazioni di Azure IoT.

Elenca le istanze

Azure portal

1. Nel portale di Azure, cercare e selezionare Operazioni di Azure IoT.
2. Usare i filtri per visualizzare le istanze di Operazioni di Azure IoT in base alla sottoscrizione, al gruppo di risorse e altro ancora.

Interfaccia della riga di comando di Azure

Usare il comando az iot ops list per visualizzare tutte le istanze di Operazioni di Azure IoT nella sottoscrizione o nel gruppo di risorse.

Il comando di base restituisce tutte le istanze nella sottoscrizione.

az iot ops list

Per filtrare i risultati in base al gruppo di risorse, aggiungere il parametro --resource-group.

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

Visualizzare l'istanza

Azure portal

È possibile visualizzare l'istanza di Operazioni di Azure IoT nel portale di Azure.

1. Nel portale di Azure. passare al gruppo di risorse che contiene l'istanza di Operazioni di Azure IoT oppure cercare e selezionare Operazioni di Azure IoT.

2. Selezionare il nome dell'istanza di Operazioni di Azure IoT.

3. Nella pagina Panoramica dell'istanza, nella tabella Delle estensioni Arc vengono visualizzate le risorse distribuite nel cluster.

   

Interfaccia della riga di comando di Azure

Usare il comando az iot ops show per visualizzare le proprietà di un'istanza.

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

È anche possibile usare il comando az iot ops show per visualizzare le risorse nella distribuzione di Operazioni di Azure IoT nell'interfaccia della riga di comando di Azure. Aggiungere il flag --tree per accedere alla una visualizzazione albero della distribuzione che include l'istanza di Operazioni di Azure IoT specificata.

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

La visualizzazione albero di una distribuzione è simile all'esempio seguente:

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

È possibile eseguire az iot ops check nel cluster per valutare l'integrità e le configurazioni dei singoli componenti di Operazioni di Azure IoT. Per impostazione predefinita, il comando controlla MQ, ma è possibile specificare il servizio con il parametro --ops-service.

Aggiornare i tag e la descrizione dell'istanza

Azure portal

1. Nel portale di Azure. passare al gruppo di risorse che contiene l'istanza di Operazioni di Azure IoT oppure cercare e selezionare Operazioni di Azure IoT.

2. Selezionare il nome dell'istanza di Operazioni di Azure IoT.

3. Nella pagina Panoramica dell'istanza, selezionare Aggiungi tag o modifica per modificare i tag nell'istanza.

Interfaccia della riga di comando di Azure

Usare il comando az iot ops update per modificare i tag e i parametri di descrizione dell'istanza di Operazioni di Azure IoT. I valori forniti nel comando update sostituiscono qualsiasi tag o descrizione esistenti

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

Per eliminare tutti i tag in un'istanza, impostare il parametro tags su un valore Null. Ad esempio:

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

Gestire i componenti

Ogni istanza di Operazioni IoT di Azure include diversi componenti, ad esempio il broker MQTT, il connettore per OPC UA e i flussi di dati. Per altre informazioni sulla gestione di questi componenti, vedere i rispettivi articoli. Ad esempio, per gestire il broker MQTT, iniziare con Panoramica di Broker.

(Anteprima) Gestire i componenti usando i manifesti di distribuzione kubernetes

In generale, Azure IoT Operations usa la piattaforma Azure Arc per offrire un'esperienza cloud ibrida in cui è possibile gestire la configurazione tramite Azure Resource Manager (ARM) e strumenti front-end come il portale di Azure, Bicep e l'interfaccia della riga di comando di Azure.

Tuttavia, è anche possibile gestire i componenti delle operazioni IoT di Azure usando i manifesti di distribuzione kubernetes YAML. Ciò significa che è possibile usare strumenti come kubectl per gestire alcuni componenti delle operazioni di Azure IoT. Questa funzionalità è in anteprima e presenta alcune limitazioni:

• Solo alcuni componenti supportano l'uso di manifesti di distribuzione Kubernetes. Questi componenti sono il broker MQTT e i flussi di dati. Altri componenti come il connettore per i servizi OPC UA e Akri non supportano questa funzionalità.
• A meno che le operazioni di Azure IoT vengano distribuite con la sincronizzazione delle risorse abilitata con az iot ops create --enable-rsync, le modifiche apportate alle risorse che usano manifesti di distribuzione Kubernetes non vengono sincronizzate con Azure. Per altre informazioni sulla sincronizzazione delle risorse, vedere Sincronizzazione risorse.
• Anche se la sincronizzazione delle risorse è abilitata, le nuove risorse create con manifesti di distribuzione Kubernetes non vengono sincronizzate con Azure. Vengono sincronizzate solo le modifiche apportate alle risorse esistenti.

Disinstalla

L'interfaccia della riga di comando di Azure e il portale di Azure offrono diverse opzioni per la disinstallazione di Operazioni di Azure IoT.

I passaggi portale di Azure possono eliminare un'istanza di Operazioni IoT di Azure, ma non possono influire sulle risorse correlate nella distribuzione. Se si vuole eliminare l'intera distribuzione, usare l'interfaccia della riga di comando di Azure.

Azure portal

1. Nel portale di Azure. passare al gruppo di risorse che contiene l'istanza di Operazioni di Azure IoT oppure cercare e selezionare Operazioni di Azure IoT.

2. Selezionare il nome dell'istanza di Operazioni di Azure IoT.

3. Nella pagina Panoramica dell'istanza selezionare Elimina.

4. Esaminare l'elenco delle risorse che vengono e non vengono eliminate come parte di questa operazione, quindi digitare il nome dell'istanza e selezionare Elimina per confermare.

   

Interfaccia della riga di comando di Azure

Digitare il comando az iot ops delete per eliminare l'intera distribuzione di Operazioni di Azure IoT da un cluster. Il comando delete valuta le risorse correlate a Operazioni di Azure IoT nel cluster e presenta una visualizzazione albero delle risorse da eliminare. Il cluster deve essere online quando si esegue questo comando.

Il delete comando semplifica la ridistribuzione delle operazioni IoT di Azure nello stesso cluster. Annulla il create comando in modo che sia possibile eseguire createdi nuovo , deletee create così via senza dover rieseguire init.

Il comando delete rimuove:

• Istanza di Operazioni di Azure IoT
• Estensioni Arc
• Località personalizzate
• Regole di sincronizzazione delle risorse
• Risorse che è possibile configurare nella soluzione Operazioni di Azure IoT, ad esempio asset, broker MQTT e flussi di dati.

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

Per eliminare l'istanza e rimuovere anche le dipendenze di Operazioni IoT di Azure (output di init), aggiungere il flag --include-deps.

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