Distribuire le operazioni di Azure IoT in un cluster di test

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

Per distribuire Azure IoT Operations in un cluster di produzione, vedere Deploy Azure IoT Operations in un cluster di produzione.

Prima di iniziare

Questo articolo illustra Azure IoT Operations deployments e instances che sono due concetti diversi:

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

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

• Una Azure IoT Operations instance è la risorsa padre che aggrega la suite di servizi definiti in Che è Azure IoT Operations? come broker MQTT, flussi di dati e connettore per OPC UA.

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

Prerequisiti

Risorse cloud:

• Sottoscrizione Azure.

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

Risorse per lo sviluppo:

• Azure CLI installato nel computer di sviluppo. Questo scenario richiede Azure CLI versione 2.53.0 o successiva. Usare az --version per controllare la versione e az upgrade per aggiornare, se necessario. Per altre informazioni, vedere Come installare il Azure CLI.

Un host del cluster:

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

  Se è stato distribuito Azure IoT Operations nel cluster in precedenza, disinstallare tali risorse prima di continuare. Per altre informazioni, vedere Update Azure IoT Operations.

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 Azure CLI, quindi sono necessari i prerequisiti Azure CLI descritti nella sezione precedente.

1. Accedere a Azure portal.

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

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 Azure IoT Operations.
   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.
   Componenti facoltativi per la distribuzione > Connettore OPC UA	Scegliere di distribuire il connettore facoltativo per il componente OPC UA.

5. Selezionare Avanti: Configurazione.

6. Nella scheda Configurazione specificare le informazioni seguenti:

   Parametro	Valore
   nome Azure IoT Operations	Optional: sostituire il nome predefinito per l'istanza di Azure IoT Operations.
   Configurazione del broker MQTT	Facoltativo: modificare le impostazioni predefinite per il broker MQTT. Nel portale di Azure è possibile configurare le impostazioni di cardinalità e profilo di memoria. Per configurare altre impostazioni, tra cui il buffer dei messaggi basato su disco e le opzioni avanzate del client MQTT, vedere Azure CLI supporto 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.

   screenshot

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 Selezionare Azure Storage contenitore.

   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 schemi richiede un account Azure Storage con spazio dei nomi gerarchico e con 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. Azure IoT Operations usa namespaces per organizzare asset e dispositivi. Ogni istanza di Azure IoT Operations usa un singolo spazio dei nomi per gli asset e i dispositivi. Nella scheda Gestione delle dipendenze selezionare uno spazio dei nomi del Registro di sistema dei dispositivi Azure esistente oppure 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 Azure IoT Operations.
      Nome	Specificare un nome univoco per lo spazio dei nomi.
      Regione	Selezionare la regione di Azure per archiviare il namespace.

      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.

    screenshot

11. Selezionare Avanti: Automazione.

Eseguire comandi Azure CLI

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

Una alla volta, eseguire ogni comando Azure CLI nella scheda Automation in un terminale:

1. Accedere a Azure CLI 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 CLI di Azure IoT Operations più recente, se non l'avete già fatto.

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

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

4. Preparare il cluster per la distribuzione Azure IoT Operations. 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 Azure IoT Operations, copiare ed eseguire il comando fornito az iot ops create. 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 Azure CLI, è possibile chiudere la procedura guidata Installare Azure IoT Operations.

Al termine del comando create, è disponibile un'istanza di Azure IoT Operations funzionante 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 Azure IoT Operations disponibili eseguendo il comando seguente:

az iot ops get-versions

Passaggi successivi

L'istanza di Azure IoT Operations distribuita è configurata per gli scenari di test. Se si vuole abilitare l'impostazione sicura e preparare l'istanza per gli scenari di produzione, seguire i passaggi descritti in Abilitare le impostazioni sicure in un'istanza di Azure IoT Operations esistente.