Condividi tramite

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.

  • CLI di Azure installato sulla tua macchina di sviluppo. Questo scenario richiede l'interfaccia della riga di comando di Azure, versione 2.53.0 o superiore. Usare az --version per controllare la versione e az upgrade per aggiornarla, 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

  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.

Visualizzare l'istanza

È 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 è possibile visualizzare le proprietà dell'istanza. Ad esempio, è possibile visualizzare lo stato dei connettori, che possono essere abilitati o disabilitati. Per modificare lo stato dei connettori, fare clic su Modifica.

    Screenshot che mostra l'istanza di Azure IoT Operations nel cluster abilitato con Arc e come abilitare i connettori.

    Questa azione apre un pannello di configurazione in cui è possibile abilitare o disabilitare il connettore per ONVIF.

  4. Nella scheda Riepilogo risorse vengono visualizzate le risorse distribuite nel cluster.

Visualizzare Registro Dispositivi Azure

Nel portale di Azure è possibile visualizzare Registro Dispositivi Azure, ovvero una raccolta di tutti i dispositivi e gli asset connessi all'istanza di Operazioni di Azure IoT.

Registro Dispositivi Azure usa gli spazi dei nomi per organizzare asset e dispositivi. Ogni istanza di Operazioni di Azure IoT usa un singolo spazio dei nomi per gli asset e i dispositivi. Più istanze possono condividere un singolo spazio dei nomi.

Per visualizzare gli elementi nel Registro Dispositivi Azure nel portale di Azure:

  1. Nel portale di Azure cercare e selezionare Registro Dispositivi Azure. La pagina Panoramica riepiloga il numero di asset, registri dello schema e spazi dei nomi nella sottoscrizione:

    Screenshot della pagina di panoramica di Registro Dispositivi Azure nel portale di Azure.

  2. Usare la pagina Asset per visualizzare gli asset in Registro Dispositivi Azure. Per impostazione predefinita, la pagina Asset mostra gli asset in tutti gli spazi dei nomi nella sottoscrizione. Usare i filtri per visualizzare un sottoinsieme degli asset, ad esempio gli asset in uno spazio dei nomi o un gruppo di risorse specifico:

    Screenshot della pagina Asset del Registro Dispositivi Azure nel portale di Azure.

  3. Usare la pagina Registri schemi per visualizzare i registri dello schema in Registro Dispositivi Azure. Per impostazione predefinita, la pagina Registri schemi mostra i registri dello schema in tutti gli spazi dei nomi nella sottoscrizione. Usare i filtri per visualizzare un subset dei registri dello schema, ad esempio i registri dello schema in uno spazio dei nomi o un gruppo di risorse specifico:

    Screenshot della pagina Registri schemi di Registro Dispositivi Azure nel portale di Azure.

  4. Usare la pagina Spazi dei nomi per visualizzare gli spazi dei nomi in Registro dispositivi Azure. Per impostazione predefinita, la pagina Spazi dei nomi mostra gli spazi dei nomi nella sottoscrizione. Usare i filtri per visualizzare un sottoinsieme degli spazi dei nomi, ad esempio gli spazi dei nomi in un gruppo di risorse specifico. Da questa pagina è possibile creare nuovi spazi dei nomi o visualizzare i dettagli degli spazi dei nomi esistenti:

    Screenshot della pagina Spazi dei nomi del Registro Dispositivi Azure nel portale di Azure.

È anche possibile visualizzare i dettagli di uno spazio dei nomi esistente nel gruppo di risorse che include l'istanza di Operazioni di Azure IoT. Ad esempio, lo screenshot seguente mostra la risorsa adr-namespace associata all'istanza di Operazioni di Azure IoT aio-131235032 :

Screenshot del portale di Azure che mostra le risorse nel gruppo di risorse.

Lo screenshot precedente mostra anche le altre risorse in Registro Dispositivi Azure, ad esempio registro schemi IoT, asset dello spazio dei nomi IoT e dispositivi nel contesto del gruppo di risorse che contiene l'istanza di Operazioni IoT Azure.

Eseguire la migrazione degli asset (classici) agli asset

Se nell'istanza di Azure IoT Operations sono presenti asset esistenti che si desidera spostare in uno spazio dei nomi, è possibile usare il az iot ops migrate-assets comando . Questo comando esegue la migrazione degli asset a livello radice (versione classica) agli asset in Registro dispositivi di Azure.

Annotazioni

La migrazione degli asset richiede l'istanza di Azure IoT Operations versione 1.2.36 o successiva.

Il insieme di asset di destinazione (versione classica) viene convertito in una rappresentazione equivalente degli asset, e sostituisce l'asset di livello radice originale (versione classica). Durante la migrazione, i dispositivi vengono creati al posto dei profili endpoint a cui fanno riferimento gli asset radice. Se più asset fanno riferimento allo stesso profilo endpoint, viene fatto riferimento a un solo dispositivo dagli asset migrati.

Per eseguire la migrazione di tutti gli asset radice associati a un'istanza, eseguire il comando seguente:

az iot ops migrate-assets -n <INSTANCE_NAME> --resource-group <RESOURCE_GROUP>

Per eseguire la migrazione di asset radice specifici associati a un'istanza, eseguire il comando seguente:

az iot ops migrate-assets -n <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --pattern <ASSET_ID_1> <ASSET_ID_2> <ASSET_ID_3>

Per eseguire la migrazione di tutti gli asset radice associati a un'istanza che corrisponde a modelli di tipo GLOB, eseguire il comando seguente:

az iot ops migrate-assets -n <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --pattern asset-pl-* asset-eng?-01

Importante

Prima di eseguire la migrazione degli asset, assicurarsi di creare uno snapshot dell'istanza usando il az iot ops clone comando . In questo modo è possibile ripristinare lo stato precedente dell'istanza, se necessario. Per altre informazioni, vedere Clonare un'istanza di operazioni IoT.

Al termine della migrazione, è possibile usare az iot ops ns asset e az iot ops ns device comandi per gestire gli asset e i dispositivi nell'istanza di Azure IoT Operations.

Configurare i modelli di connettore

Nel portale di Azure è possibile configurare i modelli di connettore per l'istanza di Operazioni di Azure IoT. I modelli di connettore definiscono la configurazione dei connettori, ad esempio il connettore per OPC UA, distribuiti nel cluster. Quando si crea un modello di connettore, consente a un utente OT di creare un dispositivo che usa il tipo di connettore nell'interfaccia utente Web dell'esperienza operativa.

Per altre informazioni sui modelli di connettore, vedere Distribuire il connettore per ONVIF.

Gestire i componenti dell'istanza

Ogni istanza di Azure IoT Operations 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.

Gestire i componenti usando i manifesti di distribuzione Kubernetes (anteprima)

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 non si abiliti la sincronizzazione delle risorse nelle operazioni IoT di Azure usando az iot ops enable-rsync il comando , le modifiche apportate alle risorse usando 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.

Aggiornare istanze e configurazione

  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.

Disinstallare

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

Importante

Se si vuole pulire il cluster e il gruppo di risorse, è consigliabile rimuovere prima le operazioni IoT di Azure dal cluster usando i comandi dell'interfaccia della riga di comando per le operazioni di Azure IoT nella sezione seguente. È quindi possibile eliminare il gruppo di risorse. L'eliminazione diretta del gruppo di risorse lascerà le risorse orfane nel cluster.

  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.

    Screenshot che mostra l'eliminazione di un'istanza di Operazioni di Azure IoT nel portale di Azure.

Annotazioni

L'eliminazione dell'istanza di Operazioni IoT di Azure nel portale di Azure non rimuove le dipendenze create durante la distribuzione delle operazioni di Azure IoT. Per rimuovere queste dipendenze, usare il az iot ops delete --name <INSTANCE_NAME> --resource-group <RESOURCE_GROUP> --include-deps comando descritto nella procedura dell'interfaccia della riga di comando di Azure.

  • Last updated on