Esercizio - Configurare l'ambiente dell'esercizio

Completato

Importante

In questo modulo verranno create le risorse di Azure. Se non si prevede di usare di nuovo il modulo o se non lo si completa, assicurarsi di rimuovere le risorse create. Sono state incluse istruzioni per rimuovere tutte le risorse alla fine del modulo.

Questo modulo presuppone che sia installata l'interfaccia della riga di comando di Azure. È possibile eseguire comandi da una finestra del prompt dei comandi o da Windows PowerShell. È consigliabile usare PowerShell.

Il modulo presuppone anche che si disponga di un account Azure. Sono necessari i ruoli Collaboratore e Amministratore accesso utenti o Proprietario nella sottoscrizione di Azure.

Importante

Se l'utente fa parte di un'organizzazione, potrebbe essere necessario coordinarsi con il team IT per creare l'account utente di Azure Active Directory (Azure AD) e concedere i privilegi appropriati. In aggiunta, gli account guest associati alla sottoscrizione di Azure non soddisfano i requisiti minimi. È necessario avere un account membro.

La logica del modello di ARM è stata integrata in un prefab di connessione che guida un simulatore di dati.

Scaricare la soluzione e il modello di ARM

Nell'unità precedente è stato clonato o scaricato il repository da GitHub.

Accedere ad Azure con l'interfaccia della riga di comando di Azure

1. Individuare lo script azuredeploy.bicep creato automaticamente. In genere, questo file si trova nella radice della cartella del repository.

2. Dal menu Start aprire PowerShell. Tutti i comandi dell'interfaccia della riga di comando di Azure vengono eseguiti nella console di PowerShell.

3. Modificare il percorso corrente nel percorso dello script azuredeploy.bicep identificato nel passaggio 1.

   cd <path for azuredeploy.bicep>
   

4. Accedere ad Azure con il comando az login. Viene aperta una finestra del browser e viene richiesta l'autenticazione.

   Nota

   Se il comando non riesce ad aprire la finestra del browser appropriata, usare questo comando: az login --use-device-code. Questo flusso di codice del dispositivo restituisce un codice univoco. Aprire la pagina di accesso del dispositivo nel browser e immettere il codice visualizzato nel terminale.

Impostare le variabili in PowerShell

1. Impostare la variabile $projectname. Questo valore rappresenta il nome univoco di base per le risorse di Azure create in questo esercizio. Al nome del progetto verranno poi aggiunti alcuni caratteri casuali. Assicurarsi che i valori siano racchiusi tra virgolette.

   Nota

   Le variabili in PowerShell iniziano con il simbolo $.

   $projectname="myproj"
   

   Importante

   Il nome del progetto può essere composto da un massimo di 14 caratteri e può contenere solo lettere minuscole, numeri e il trattino (-).

2. Impostare il nome di registrazione dell'app, che può essere composto da un massimo di 14 caratteri. Questo valore rappresenta il nome di registrazione dell'applicazione per l'app per la realtà mista.

   $appreg="myappreg"
   

Creare la registrazione dell'app

Eseguire il comando seguente per creare un'entità servizio e configurarne l'accesso alle risorse di Azure.

az ad sp create-for-rbac --name ${appreg} --role Contributor --scopes /subscriptions/<SUBSCRIPTION-ID> > AppCredentials.txt

L’output di questo comando viene reindirizzato dall’output standard a un file di testo AppCredentials.txt. Il comando crea il file nella stessa directory in cui si esegue il comando. Eventuali errori che potrebbero verificarsi vengono visualizzati nella console di PowerShell. Aprire il file per recuperare le credenziali e configurare l'applicazione del simulatore di telemetria in un secondo momento.

Nota

Prestare attenzione al percorso di salvataggio del file, perché contiene le credenziali. Si consiglia di eliminare il file dopo aver completato il percorso di apprendimento.

Ottenere l'ID oggetto della registrazione dell'app e l'ID utente

1. Creare e impostare una variabile per ObjectID in PowerShell usando il comando seguente.

   $objectid=$(az ad sp list --display-name ${appreg} --query [0].objectId --output tsv)
   

2. Verificare che la variabile contenga un GUID usando il comando echo. Se non lo contiene, esaminare i passaggi precedenti.

   echo $objectid
   

3. Creare e impostare una variabile per l'ID utente.

   $userid=$(az ad signed-in-user show --query objectId -o tsv)
   

4. Verificare che la variabile contenga un GUID usando il comando echo. Se non lo contiene, esaminare i passaggi precedenti.

   echo $userid
   

   

Creare il gruppo di risorse di Azure

Creare il gruppo di risorse usando il comando az group create in PowerShell:

az group create --name ${projectname}-rg --location eastus

Prestare particolare attenzione al percorso, che deve essere eastus. Questa area è una delle aree valide per Microsoft.SignalRService/SignalR e Microsoft.DigitalTwins/digitalTwinsInstances.

Distribuire il modello di ARM nel gruppo di risorse appena creato

Distribuire il file bicep fornito nel gruppo di risorse e reindirizzare l'output a un file di testo denominato ARM_deployment_out.txt. Il completamento di questo processo può richiedere da 10 a 15 minuti.

az deployment group create --template-file azuredeploy.bicep --resource-group ${projectname}-rg `
   --parameters projectName=${projectname} userId=${userid} appRegObjectId=${objectid} `
   > ARM_deployment_out.txt

Il file è solo un riferimento e non è necessario per il resto del modulo.

Nota

È possibile che si ricevano diversi messaggi di AVVISO relativi alla ridenominazione URI valida, che indicano che l'output contiene le credenziali e il tipo di disponibilità. Esaminare gli avvisi, sebbene non sia necessaria alcuna azione immediata, poiché non hanno alcun effetto su questo modulo.

Suggerimento

Se è necessario creare di nuovo le risorse di Azure per un qualsiasi motivo, assicurarsi di eliminare tutte le istanze precedenti di risorse e gruppi di risorse.

Installare l'estensione dell'interfaccia della riga di comando di Azure

Installare l'estensione azure-iot per l'interfaccia della riga di comando di Azure in PowerShell usando il comando az extension in PowerShell.

az extension add --name azure-iot

Questo comando scarica e installa l'estensione. Se è già installata, viene visualizzato un avviso.

Eseguire query sulla distribuzione di Azure per i parametri di configurazione chiave

Eseguire una query sulla distribuzione di Azure usando il comando az deployment group show in PowerShell. Questo comando reindirizza l'output a un file denominato Azure_config_settings.txt presente nella stessa directory in cui viene eseguito il comando.

az deployment group show --name azuredeploy --resource-group ${projectname}-rg `
   --query properties.outputs.importantInfo.value > Azure_config_settings.txt

Eseguire query sulla distribuzione di Azure per il parametro di connessione del gruppo di risorse

1. Usare il comando az iot hub connection-string show per eseguire una query sull'hub IoT per il parametro della stringa di connessione del gruppo di risorse, che verrà usato più avanti nel modulo.

   az iot hub connection-string show --resource-group ${projectname}-rg >> Azure_config_settings.txt
   

   Questo comando reindirizza e aggiunge l'output a un file denominato Azure_config_settings.txt presente nella stessa directory in cui viene eseguito il comando. Questo file è stato creato nella sezione precedente. I due simboli > indicano che il comando aggiunge, anziché sovrascrivere.

2. Verificare il contenuto del file di testo di output in PowerShell. Questo comando visualizza diversi parametri di configurazione chiave da usare in seguito nel modulo.

   get-content Azure_config_settings.txt