Creare ed effettuare il provisioning di un dispositivo IoT Edge per Linux in Windows usando chiavi simmetriche

Un hub IoT gratuito o standard nella sottoscrizione di Azure.

• Un hub IoT gratuito o standard nella sottoscrizione di Azure
• Visual Studio Code
• Estensione Azure IoT Hub
• Azure IoT Edge per Visual Studio Code

• Un hub IoT gratuito o standard nella sottoscrizione di Azure

• Interfaccia della riga di comando di Azure nell'ambiente in uso

  La versione dell'interfaccia della riga di comando di Azure deve essere 2.0.70 o successiva. Usare il comando az --version per verificare. Questa versione supporta i comandi dell'estensione az e introduce il framework dei comandi Knack.

Se si vuole usare PowerShell, seguire questa procedura per preparare il dispositivo di destinazione per l'installazione di Azure IoT Edge per Linux in Windows e la distribuzione della macchina virtuale Linux:

1. Impostare il criterio di esecuzione nel dispositivo di destinazione su AllSigned. È possibile controllare il criterio di esecuzione corrente in un prompt di PowerShell con privilegi elevati, usando il comando seguente:

   Get-ExecutionPolicy -List
   

   Se il criterio di esecuzione di local machine non è AllSigned, è possibile impostarlo come segue:

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

Per altre informazioni sul modulo PowerShell di Azure IoT Edge per Linux in Windows, vedere le informazioni di riferimento sulle funzioni di PowerShell.

Per usare Windows Admin Center, seguire questa procedura per scaricare e installare Windows Admin Center e installare l'estensione Azure IoT Edge di Windows Admin Center:

1. Scaricare ed eseguire il programma di installazione di Windows Admin Center. Seguire le istruzioni dell'installazione guidata per installare Windows Admin Center.

2. Dopo l'installazione, usare un browser supportato per aprire Windows Admin Center. I browser supportati includono Microsoft Edge (Windows 10, versione 1709 o successiva), Google Chrome e Microsoft Edge Insider.

3. Al primo uso di Windows Admin Center, verrà richiesto di selezionare un certificato da usare. Selezionare Client di Windows Admin Center come certificato.

4. Installare l'estensione Azure IoT Edge. Selezionare l'icona a forma di ingranaggio in alto a destra nel dashboard di Windows Admin Center.

   

5. Nel menu Impostazioni, in Gateway selezionare Estensioni.

6. Nella scheda Estensioni disponibili trovare Azure IoT Edge nell'elenco delle estensioni. Scegliere l'estensione e selezionare il prompt Installa sopra l'elenco di estensioni.

7. Al termine dell'installazione, azure IoT Edge verrà visualizzato nell'elenco delle estensioni installate nella scheda Estensioni installate.

Nell'hub IoT sul portale di Azure, i dispositivi IoT Edge vengono creati e gestiti separatamente dai dispositivi IoT non abilitati per Edge.

1. Accedere al portale di Azure e passare all'hub IoT.

2. Nel riquadro sinistro selezionare Dispositivi dal menu e quindi scegliere Aggiungi dispositivo.

3. Nella pagina Crea un dispositivo specificare le informazioni seguenti:

   • Creare un ID dispositivo descrittivo. Prendere nota di questo ID dispositivo, perché verrà usato in un secondo momento.
   • Selezionare la casella di controllo Dispositivo IoT Edge.
   • Selezionare Chiave simmetrica come tipo di autenticazione.
   • Usare le impostazioni predefinite per la generazione automatica delle chiavi di autenticazione e la connessione del nuovo dispositivo all'hub.

4. Seleziona Salva.

Eseguire l'accesso all'hub IoT

Per eseguire operazioni con l'hub IoT, è possibile usare le estensioni Azure IoT per Visual Studio Code. Per consentire il funzionamento di queste operazioni, è necessario accedere all'account Azure e selezionare l'hub.

1. In Visual Studio Code aprire la finestra di esplorazione.

2. Nella parte inferiore di Explorer, espandere la sezione Hub IoT di Azure.

   

3. Fare clic sui puntini di sospensione (...) nell'intestazione della sezione Hub IoT di Azure. Se i puntini di sospensione non sono visibili, passare il puntatore sull'intestazione o fare clic su di essa.

4. Scegliere Select IoT Hub (Seleziona l'hub IoT).

5. Se ancora non lo si è fatto, eseguire l'accesso all'account di Azure seguendo le istruzioni.

6. Selezionare la sottoscrizione di Azure.

7. Selezionare l'hub IoT.

Registrare un nuovo dispositivo con Visual Studio Code

1. In Esplora risorse di Visual Studio Code espandere la sezione hub IoT di Azure.
2. Fare clic sui puntini di sospensione (...) nell'intestazione della sezione Hub IoT di Azure. Se i puntini di sospensione non sono visibili, passare il puntatore sull'intestazione o fare clic su di essa.
3. Selezionare Create IoT Edge Device (Crea dispositivo IoT Edge).
4. Nella casella di testo che si apre specificare un ID per il dispositivo.

Nella schermata di output viene visualizzato il risultato del comando. Vengono stampate le informazioni relative al dispositivo, che includono il valore di deviceId fornito dall'utente e il valore di connectionString utilizzabile per connettere il dispositivo fisico all'hub IoT.

Usare il comando az iot hub device-identity create per creare una nuova identità del dispositivo nell'hub IoT. Ad esempio:

az iot hub device-identity create --device-id device_id_here --hub-name hub_name_here --edge-enabled

Questo comando include tre parametri:

• --device-id o -d: specificare un nome descrittivo univoco per l'hub IoT.

• --hub-name o -n: specificare il nome dell'hub IoT.

• --edge-enabled o --ee: dichiarare che si tratta di un dispositivo IoT Edge.

  

I dispositivi abilitati per Edge che si connettono all'hub IoT sono elencati nella pagina Dispositivi. È possibile filtrare l'elenco in base al tipo dispositivo Iot Edge.

Quando si è pronti per configurare il dispositivo, è necessaria la stringa di connessione che collega il dispositivo fisico alla relativa identità nell'hub IoT.

I dispositivi che eseguono l'autenticazione con chiavi simmetriche hanno le stringhe di connessione disponibili per la copia nel portale.

1. Nella pagina Dispositivi del portale selezionare l'ID dispositivo IoT Edge dall'elenco.
2. Copiare il valore Stringa di connessione primaria o Stringa di connessione secondaria.

Tutti i dispositivi connessi all'hub IoT sono elencati nella sezione Hub IoT di Azure della finestra Explorer di Visual Studio Code. I dispositivi IoT Edge si distinguono dai dispositivi non Edge per la presenza di un'icona di tipo diverso e per la distribuzione dei moduli $edgeAgent e $edgeHub in ogni dispositivo IoT Edge.

Quando si è pronti per configurare il dispositivo, è necessaria la stringa di connessione che collega il dispositivo fisico alla relativa identità nell'hub IoT.

1. Fare clic con il pulsante destro del mouse sull'ID del dispositivo nella sezione Hub IoT di Azure.

2. Selezionare Copy Device Connection String (Copia stringa di connessione dispositivo).

   La stringa di connessione verrà copiata negli Appunti.

È anche possibile selezionare Get Device Info (Ottieni info dispositivo) dal menu di scelta rapida per visualizzare nella finestra di output tutte le informazioni relative al dispositivo, inclusa la stringa di connessione.

Usare il comando az iot hub device-identity list per visualizzare tutti i dispositivi nell'hub IoT. Ad esempio:

az iot hub device-identity list --hub-name hub_name_here

Per qualsiasi dispositivo registrato come dispositivo IoT Edge, la proprietà capabilities.iotEdge sarà impostata su true.

Quando si è pronti per configurare il dispositivo, è necessaria la stringa di connessione che collega il dispositivo fisico alla relativa identità nell'hub IoT. Usare il comando az iot hub device-identity connection-string show per restituire il stringa di connessione per un singolo dispositivo:

az iot hub device-identity connection-string show --device-id [device_id] --hub-name [hub_name]

Per il parametro device-id viene fatta distinzione tra maiuscole e minuscole.

Quando si copia la stringa di connessione da usare in un dispositivo, non includere le virgolette intorno alla stringa di connessione.

Installare IoT Edge per Linux in Windows nel dispositivo di destinazione.

1. In una sessione di PowerShell con privilegi elevati, eseguire ognuno dei comandi seguenti per scaricare IoT Edge per Linux in Windows.

   $msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
   $ProgressPreference = 'SilentlyContinue'
   Invoke-WebRequest "https://aka.ms/AzEflowMSI" -OutFile $msiPath
   

2. Installare IoT Edge per Linux in Windows nel dispositivo.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn"
   

   È possibile specificare directory personalizzate per l'installazione di IoT Edge per Linux in Windows e per il file VHDX, semplicemente aggiungendo i parametri INSTALLDIR="<FULLY_QUALIFIED_PATH>" e VHDXDIR="<FULLY_QUALIFIED_PATH>" al comando di installazione. Ad esempio, se si vuole usare la cartella D:\EFLOW per l'installazione e la cartella D:\EFLOW-VHDX per il file VHDX, si può usare il cmdlet di PowerShell seguente.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn","INSTALLDIR=D:\EFLOW", "VHDXDIR=D:\EFLOW-VHDX"
   

3. Impostare su AllSigned il criterio di esecuzione nel dispositivo di destinazione, se l'operazione non è già stata eseguita. Vedere i prerequisiti di PowerShell per i comandi per il controllo del criterio di esecuzione corrente e impostare il criterio di esecuzione su AllSigned.

4. Creare la distribuzione di IoT Edge per Linux in Windows. La distribuzione crea la macchina virtuale Linux e installa automaticamente il runtime IoT Edge.

   Deploy-Eflow
   

   Suggerimento

   Per impostazione predefinita, il comando Deploy-Eflow crea la macchina virtuale Linux con 1 GB di RAM, 1 core di vCPU e 16 GB di spazio su disco. Tuttavia, le risorse necessarie alla macchina virtuale dipendono fortemente dai carichi di lavoro distribuiti. Se la macchina virtuale non dispone di memoria sufficiente per supportare i carichi di lavoro, non sarà possibile avviarla.

   È possibile personalizzare le risorse disponibili della macchina virtuale usando i parametri facoltativi del comando Deploy-Eflow.

   Ad esempio, il comando seguente crea una macchina virtuale con 4 core vCPU, 4 GB di RAM (rappresentati in MB) e 20 GB di spazio su disco:

   Deploy-Eflow -cpuCount 4 -memoryInMB 4096 -vmDiskSize 20
   

   Per informazioni su tutti i parametri facoltativi disponibili, vedere Funzioni di PowerShell per IoT Edge per Linux in Windows.

   Avviso

   Per impostazione predefinita, la macchina virtuale EFLOW Linux non dispone di alcuna configurazione DNS. Le distribuzioni basate su DHCP tenteranno di ottenere la configurazione DNS propagata dal server DHCP. Per garantire l'accesso a Internet, controllare la configurazione DNS. Per altre informazioni, vedere AzEFLOW-DNS.

   È possibile assegnare una GPU alla distribuzione per abilitare i moduli Linux con accelerazione GPU. Per ottenere l'accesso a queste funzionalità, è necessario installare i prerequisiti descritti in dettaglio in Accelerazione GPU per Azure IoT Edge per Linux in Windows.

   Per usare un pass-through GPU, aggiungere i parametri gpuName, gpuPassthroughType e gpuCount al comando Deploy-Eflow. Per informazioni su tutti i parametri facoltativi disponibili, vedere Funzioni di PowerShell per IoT Edge per Linux in Windows.

   Avviso

   L'abilitazione del pass-through del dispositivo hardware può aumentare i rischi per la sicurezza. Microsoft consiglia l'uso di un driver di mitigazione dei dispositivi prodotto dal fornitore della GPU, se applicabile. Per altre informazioni, vedere Distribuire dispositivi grafici usando l'assegnazione di dispositivi discreti.

5. Immettere "Y" per accettare le condizioni di licenza.

6. Immettere "O" o "R" per attivare o disattivare i Dati di diagnostica facoltativi in base alle proprie preferenze.

7. Al termine della distribuzione, nella finestra di PowerShell compare l'indicazione La distribuzione è riuscita.

   

   Dopo aver completato la distribuzione, è possibile eseguire il provisioning del dispositivo.

1. Installare e aprire Windows Admin Center.

   Nella pagina iniziale di Windows Admin Center, sotto l'elenco delle connessioni, verrà visualizzata una connessione host locale che rappresenta il PC in cui si esegue Windows Admin Center. Tutti i server, i PC o i cluster aggiuntivi gestiti verranno visualizzati qui.

   È possibile usare Windows Admin Center per gestire Azure IoT Edge per Linux in Windows nel dispositivo locale o nei dispositivi gestiti da remoto. In questa guida la connessione host locale fungerà da dispositivo di destinazione per la distribuzione di Azure IoT Edge per Linux in Windows.

2. Verificare che il dispositivo locale sia elencato in Tutte le connessioni, come illustrato di seguito.

   

   Se si vuole eseguire la distribuzione in un dispositivo di destinazione remota anziché nel dispositivo locale e non viene visualizzato il dispositivo di destinazione desiderato nell'elenco, seguire le istruzioni per aggiungere il dispositivo.

3. Selezionare + Aggiungi per iniziare a creare la distribuzione. La distribuzione crea la macchina virtuale Linux e installa automaticamente il runtime IoT Edge.

4. Nel riquadro Aggiungi o crea risorse individuare il riquadro Azure IoT Edge . Selezionare Crea nuovo per installare una nuova istanza di Azure IoT Edge per Linux in Windows in un dispositivo.

   Se si dispone già di IoT Edge per Linux in esecuzione in un dispositivo, è possibile selezionare Aggiungi per connettersi al dispositivo IoT Edge esistente e gestirlo con Windows Admin Center.

   

5. Verrà aperto il riquadro Crea un'istanza di Azure IoT Edge per Linux in Windows . Sulla 1. Scheda Attività iniziali, esaminare i requisiti minimi e selezionare Avanti.

6. Esaminare le condizioni di licenza, selezionare Accetto e selezionare Avanti.

7. È possibile attivare o disattivare i dati di diagnostica facoltativi, a seconda delle preferenze.

8. Selezionare Avanti: Distribuisci.

   

9. Il 2. Scheda Distribuisci, in Selezionare un dispositivo di destinazione fare clic sul dispositivo elencato per convalidarlo in base ai requisiti minimi. Dopo aver confermato lo stato come supportato, selezionare Avanti.

   

10. Nella scheda Impostazioni 2.2 esaminare le impostazioni di configurazione della distribuzione. La tabella seguente mostra le impostazioni e i relativi valori predefiniti.

    Impostazione	Valore predefinito
    Dimensioni del disco virtuale in GB	16
    Memoria in MB (numero pari)	1024
    Numero di core	2
    Versione di Azure IoT Edge	1.1 (LTS)

    Nota

    IoT Edge per Linux in Windows usa un commutatore predefinito, che assegna alla macchina virtuale Linux un indirizzo IP interno. Questo indirizzo IP interno non può essere raggiunto dall'esterno del computer Windows. È possibile connettersi alla macchina virtuale in locale durante l'accesso al computer Windows.

    Se si usa Windows Server, configurare un'opzione predefinita prima di distribuire IoT Edge per Linux in Windows.

    È possibile assegnare una GPU alla distribuzione per abilitare i moduli Linux con accelerazione GPU. Per ottenere l'accesso a queste funzionalità, è necessario installare i prerequisiti descritti in dettaglio in Accelerazione GPU per Azure IoT Edge per Linux in Windows. Se si installano solo questi prerequisiti a questo punto del processo di distribuzione, sarà necessario ricominciare dall'inizio.

    Sono disponibili due opzioni per il pass-through GPU: Assegnazione diretta del dispositivo (DDA) e Paravirtualization GPU (GPU-PV), a seconda dell'adattatore GPU assegnato alla distribuzione.

    Per il metodo di assegnazione diretta del dispositivo, selezionare il numero di processori GPU da allocare alla macchina virtuale Linux.

    Per il metodo di paravirtualizzazione, non sono necessarie impostazioni aggiuntive.

    Avviso

    L'abilitazione del pass-through del dispositivo hardware può aumentare i rischi per la sicurezza. Microsoft consiglia l'uso di un driver di mitigazione dei dispositivi prodotto dal fornitore della GPU, se applicabile. Per altre informazioni, vedere Distribuire dispositivi grafici usando l'assegnazione di dispositivi discreti.

    Dopo aver soddisfatto le impostazioni, selezionare Avanti.

11. Nella scheda Distribuzione 2.3 è possibile controllare lo stato di avanzamento della distribuzione. Il processo completo include il download del pacchetto Azure IoT Edge per Linux in Windows, l'installazione del pacchetto, la configurazione del dispositivo host e la configurazione della macchina virtuale Linux. Il processo può richiedere alcuni minuti. Di seguito è riportata una distribuzione corretta.

    

12. Al termine della distribuzione, è possibile eseguire il provisioning del dispositivo. Selezionare Avanti: Connetti per procedere con 3. Scheda Connetti , che gestisce il provisioning dei dispositivi Azure IoT Edge.

Eseguire il comando seguente in una sessione di PowerShell con privilegi elevati nel dispositivo di destinazione. Sostituire il testo segnaposto con i propri valori.

Provision-EflowVm -provisioningType ManualConnectionString -devConnString "PASTE_DEVICE_CONNECTION_STRING_HERE"

Per altre informazioni sul comandoProvision-EflowVM, vedere Funzioni di PowerShell per IoT Edge per Linux in Windows.

1. Nel riquadro Device Provisioning di Azure IoT Edge selezionare Stringa di connessione (manuale) dall'elenco a discesa metodo di provisioning.

2. Specificare l'stringa di connessione dispositivo recuperato da hub IoT dopo la registrazione del dispositivo.

3. Selezionare Provisioning con il metodo selezionato.

   

4. Al termine del provisioning, selezionare Fine. Si tornerà al dashboard principale. Verrà ora visualizzato un nuovo dispositivo elencato con il tipo IoT Edge Devices. È possibile selezionare il dispositivo IoT Edge a cui connettersi. Una volta visualizzata la pagina Panoramica, è possibile visualizzare l'elenco dei moduli IoT Edge e lo stato di IoT Edge del dispositivo.

1. Accedere alla macchina virtuale IoT Edge per Linux in Windows usando il comando seguente nella sessione di PowerShell:

   Connect-EflowVm
   

   Nota

   L'unico account autorizzato a connettersi tramite SSH alla macchina virtuale è quello dell'utente che lo ha creato.

2. Dopo aver eseguito l'accesso, è possibile controllare l'elenco dei moduli IoT Edge in esecuzione usando il comando Linux seguente:

   sudo iotedge list
   

3. Se è necessario risolvere i problemi del servizio IoT Edge, utilizzare i comandi Linux seguenti.

   1. Recuperare i log del servizio.

      sudo journalctl -u iotedge
      

   2. Usare lo strumento check per verificare lo stato di configurazione e connessione del dispositivo.

      sudo iotedge check
      

   Nota

   In un dispositivo di cui è stato appena effettuato il provisioning potrebbe essere visualizzato un errore correlato all'hub di IoT Edge:

   × idoneità alla produzione: la directory di archiviazione dell'hub di Edge è persistente nel file system host - Errore

   Non è stati possibile controllare lo stato corrente del contenitore edgeHub

   Questo errore è previsto in un dispositivo di cui è stato appena effettuato il provisioning, perché il modulo hub di IoT Edge non è in esecuzione. Per risolvere l'errore, nell'hub IoT impostare i moduli per il dispositivo e creare una distribuzione. La creazione di una distribuzione per il dispositivo avvia i moduli nel dispositivo, incluso il modulo hub di IoT Edge.

1. Selezionare il dispositivo IoT Edge dall'elenco dei dispositivi connessi in Windows Admin Center per connettersi.

2. La pagina di panoramica del dispositivo visualizza alcune informazioni sul dispositivo:

   • La sezione Elenco moduli IoT Edge mostra i moduli in esecuzione nel dispositivo. Quando il servizio IoT Edge viene avviato per la prima volta, dovrebbe essere visualizzato solo il modulo edgeAgent in esecuzione. Il modulo edgeAgent viene eseguito per impostazione predefinita e permette di installare e avviare tutti i moduli aggiuntivi distribuiti nel dispositivo.

   • La sezione Stato di IoT Edge mostra lo stato del servizio e deve essere attiva (in esecuzione).