Distribuire Operazioni di Azure IoT in un cluster di test

Informazioni su come distribuire Operazioni di Azure IoT in un cluster di test, ovvero un cluster Kubernetes abilitato per Arc che è possibile usare per scenari di test e valutazione.

Per distribuire Operazioni di Azure IoT in un cluster di produzione, vedere Distribuire Operazioni di Azure IoT in un cluster di produzione.

Prima di iniziare

Questo articolo illustra le distribuzioni e le istanze di Operazioni di Azure IoT, che sono due concetti diversi:

• Una distribuzione di Azure IoT Operations descrive tutti i componenti e le risorse che abilitano lo scenario operazioni di Azure IoT. Questi componenti e risorse includono:

  • Istanza di Operazioni di Azure IoT
  • Estensioni Arc
  • Località personalizzate
  • Risorse che è possibile configurare nella soluzione Operazioni IoT di Azure, ad esempio asset e dispositivi.

• Un'istanza di Azure IoT Operations è la risorsa padre che aggrega la suite di servizi definiti in Informazioni sulle operazioni di Azure IoT, ad esempio broker MQTT, flussi di dati e connettore per OPC UA.

Quando si parla della distribuzione delle operazioni IoT di Azure, si intende il set completo di componenti che costituiscono una distribuzione. Dopo aver creato la distribuzione, è possibile visualizzare, gestire e aggiornare l'istanza.

Prerequisiti

Risorse cloud:

• Una sottoscrizione di Azure.

• Autorizzazioni di accesso di Azure. Per altre informazioni, vedere Dettagli > della distribuzione Autorizzazioni necessarie.

Risorse per lo sviluppo:

• 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 aggiornare, se necessario. Per ulteriori informazioni, vedere Come installare l'interfaccia della riga di comando di Azure.

Un host del cluster:

• Disporre di un cluster Kubernetes abilitato per Azure Arc con le funzionalità abilitate di identità del carico di lavoro e della posizione personalizzata. Se non è disponibile, seguire la procedura descritta in Preparare il cluster Kubernetes abilitato per Azure Arc.

  Se la distribuzione di Operazioni di Azure IoT è stata eseguita nel cluster in precedenza, disinstallare tali risorse prima di continuare. Per altre informazioni, vedere Aggiornare le operazioni di Azure IoT.

Distribuire nel portale di Azure

L'esperienza di distribuzione del portale di Azure è uno strumento helper che genera un comando di distribuzione basato sulle risorse e sulla configurazione. Il passaggio finale consiste nell'eseguire un comando dell'interfaccia della riga di comando di Azure, quindi sono ancora necessari i prerequisiti dell'interfaccia della riga di comando di Azure descritti nella sezione precedente.

1. Accedere al portale di Azure.

2. Nella casella di ricerca cercare e selezionare Operazioni di Azure IoT.

3. Fare clic su Crea.

4. Nella scheda Nozioni di base specificare le informazioni seguenti:

   Parametro	Valore
   Abbonamento	Selezionare la sottoscrizione che contiene il cluster abilitato per Arc.
   Gruppo di risorse	Selezionare il gruppo di risorse che contiene il cluster abilitato per Arc.
   Nome del cluster	Selezionare il cluster in cui si vuole distribuire Operazioni di Azure IoT.
   Nome luogo personalizzato	Facoltativo: sostituire il nome predefinito per il percorso personalizzato.
   Versione della distribuzione	Selezionare 1.2 (versione più recente). Per altre informazioni, vedere Versioni delle operazioni IoT.

5. Selezionare Avanti: Configurazione.

6. Nella scheda Configurazione specificare le informazioni seguenti:

   Parametro	Valore
   Nome operazioni IoT di Azure	Facoltativo: sostituire il nome predefinito per l'istanza di Operazioni IoT di Azure.
   Configurazione del broker MQTT	Facoltativo: modificare le impostazioni predefinite per il broker MQTT. Nel portale di Azure è possibile configurare le impostazioni del profilo di cardinalità e memoria. Per configurare altre impostazioni, tra cui il buffer dei messaggi basato su disco e le opzioni avanzate del client MQTT, vedere Supporto dell'interfaccia della riga di comando di Azure per la configurazione avanzata del broker MQTT.
   Configurazione del profilo del flusso di dati	Facoltativo: modificare le impostazioni predefinite per i flussi di dati. Per altre informazioni, vedere Configurare il profilo del flusso di dati.

   

7. Selezionare Avanti: Gestione delle dipendenze.

8. Nella scheda Gestione dipendenze selezionare un registro schemi esistente o seguire questa procedura per crearne uno:

   1. Seleziona Crea nuovo.

   2. Specificare un nome del registro dello schema e uno spazio dei nomi del registro dello schema.

   3. Selezionare Seleziona contenitore di Archiviazione di Azure.

   4. Scegliere un account di archiviazione dall'elenco di account abilitati per gli spazi dei nomi gerarchici oppure selezionare Crea per crearne uno.

      Il Registro di sistema dello schema richiede un account Archiviazione di Azure con spazio dei nomi gerarchico e accesso alla rete pubblica abilitato. Quando si crea un nuovo account di archiviazione, scegliere un tipo di account di archiviazione per utilizzo generico v2 e impostare Spazio dei nomi gerarchico su Abilitato.

      Per ulteriori informazioni sulla configurazione dell'account di archiviazione, consultare Linee guida per la distribuzione in ambienti di produzione.

   5. Selezionare un contenitore nell'account di archiviazione o selezionare Contenitore per crearne uno.

   6. Selezionare Applica per confermare le configurazioni del Registro di sistema dello schema.

9. Operazioni di Azure IoT usa 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. Nella scheda Gestione dipendenze selezionare uno spazio dei nomi di Registro dispositivi di Azure esistente o seguire questa procedura per crearne uno:

   1. Seleziona Crea nuovo.

   2. Nella scheda Nozioni di base specificare le informazioni seguenti:

      Parametro	Valore
      Abbonamento	Selezionare la sottoscrizione.
      Gruppo di risorse	Selezionare il gruppo di risorse che contiene l'istanza di Operazioni IoT di Azure.
      Nome	Specificare un nome univoco per lo spazio dei nomi.
      Regione	Seleziona l'area di Azure in cui conservare lo spazio dei nomi.

      Seleziona Avanti per continuare.

   3. Nella scheda Tag è possibile aggiungere facoltativamente tag allo spazio dei nomi. Seleziona Avanti per continuare.

   4. Nella scheda Review + create, rivedi le tue configurazioni e seleziona Crea per creare lo spazio dei nomi.

   5. Tornare alla scheda Gestione dipendenze, quindi selezionare lo spazio dei nomi appena creato dall'elenco.

10. Nella scheda Gestione dipendenze selezionare l'opzione di distribuzione Impostazioni test. Questa opzione usa le impostazioni predefinite consigliate a scopo di test.

    

11. Selezionare Avanti: Automazione.

Eseguire i comandi dell'interfaccia della riga di comando di Azure

Il passaggio finale dell'esperienza di distribuzione del portale di Azure consiste nell'eseguire un set di comandi dell'interfaccia della riga di comando di Azure per distribuire Operazioni di Azure IoT nel cluster. I comandi vengono generati in base alle informazioni fornite nei passaggi precedenti.

Uno alla volta, eseguire ogni comando CLI di Azure nella scheda Automazione in un terminale:

1. Accedere all'interfaccia della riga di comando di Azure in modo interattivo con un browser, anche se è già stato eseguito l'accesso in precedenza. Se non si esegue l'accesso in modo interattivo, potrebbe essere visualizzato un errore che indica che il dispositivo deve essere gestito per accedere alla risorsa.

   az login
   

2. Installare l'estensione più recente dell'interfaccia della riga di comando di Azure IoT Operations, se non è già stato fatto.

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

3. Copiare ed eseguire il comando az iot ops schema registry create per creare un registro schemi usato dai componenti di Operazioni di Azure IoT. Se si sceglie di usare un registro schemi esistente, questo comando non viene visualizzato nella scheda Automazione .

4. Preparare il cluster per la distribuzione di Operazioni di Azure IoT. Copiare ed eseguire il comando az iot ops init fornito.

   Suggerimento

   Il init comando deve essere eseguito una sola volta per ogni cluster. Se è stato seguito il prerequisito facoltativo per configurare la propria autorità di certificazione emittente, seguire la procedura descritta in Bring your own issuer.

   Il completamento di questo comando potrebbe richiedere alcuni minuti. È possibile controllare lo stato della distribuzione visualizzato nel terminale.

5. Per distribuire Operazioni di Azure IoT, copiare ed eseguire il comando az iot ops create fornito. Il completamento di questo comando potrebbe richiedere alcuni minuti. È possibile controllare lo stato della distribuzione visualizzato nel terminale.

6. Al termine di tutti i comandi dell'interfaccia della riga di comando di Azure completati correttamente, è possibile chiudere la finestra della procedura guidata Installa operazioni di Azure IoT.

Completato il comando create, è disponibile un'istanza operativa di Operazioni di Azure IoT in esecuzione nel cluster. A questo punto, l'istanza è configurata per la maggior parte degli scenari di test e valutazione.

Verificare la distribuzione

Al termine della distribuzione, eseguire az iot ops check per valutare la distribuzione del servizio Operazioni di Azure IoT per l'integrità, la configurazione e l'usabilità. Il check comando consente di trovare problemi nella distribuzione e nella configurazione.

az iot ops check

Il comando check visualizza un avviso relativo ai flussi di dati mancanti, che è normale e previsto fino a quando non si crea un flusso di dati. Per altre informazioni, vedere Elaborare e instradare i dati con i flussi di dati.

È possibile controllare le configurazioni delle mappe degli argomenti, QoS e route dei messaggi aggiungendo il parametro --detail-level 2 al comando check per una visualizzazione dettagliata.

È possibile visualizzare tutte le versioni dell'estensione dell'interfaccia della riga di comando di Operazioni di Azure IoT disponibili eseguendo il comando seguente:

az iot ops get-versions

Passaggi successivi

L'istanza di Operazioni di Azure IoT distribuita è configurata per gli scenari di test. Se si vuole abilitare l'impostazione sicura e preparare l'istanza per gli scenari di produzione, seguire la procedura descritta in Abilitare impostazioni sicure in un'istanza esistente di Operazioni di Azure IoT.