Creare l'aggiornamento dei dispositivi di Azure per le risorse di hub IoT

Per iniziare a usare Aggiornamento dispositivi di Azure per hub IoT, creare un account e un'istanza di Aggiornamento dispositivi e quindi assegnare ruoli di controllo di accesso e autorizzazioni necessari per usare tali risorse. Questo articolo descrive come creare e configurare le risorse di Aggiornamento dispositivi usando il portale di Azure o l'interfaccia della riga di comando di Azure.

Un account di Aggiornamento dispositivi è una risorsa nella sottoscrizione di Azure. Un'istanza di Aggiornamento dispositivi è un contenitore logico all'interno dell'account associato a un hub IoT specifico. È possibile creare più istanze di Aggiornamento dispositivi all'interno di un account.

Un'istanza di Aggiornamento dispositivi contiene aggiornamenti e distribuzioni associati all'hub IoT. Per altre informazioni, vedere Risorse di Aggiornamento dispositivi.

Prerequisiti

Azure portal

• Istanza Standard (S1) o superiore di hub IoT di Azure.
• Se si sceglie di archiviare i log di diagnostica, un account Archiviazione di Azure per archiviare i log di diagnostica per l'istanza di Aggiornamento dispositivi.

Interfaccia della riga di comando di Azure

• Istanza Standard (S1) o superiore di hub IoT di Azure.

• Ambiente Bash in Azure Cloud Shell per l'esecuzione dei comandi dell'interfaccia della riga di comando di Azure. Selezionare Avvia Cloud Shell per aprire Cloud Shell ora oppure selezionare l'icona di Cloud Shell nella barra degli strumenti superiore del portale di Azure.

  

  Se si preferisce, è possibile eseguire i comandi dell'interfaccia della riga di comando di Azure in locale:

  1. Installare l'interfaccia da riga di comando di Azure. Eseguire az version per visualizzare la versione dell'interfaccia della riga di comando di Azure installata e le librerie dipendenti ed eseguire az upgrade per installare la versione più recente.
  2. Accedere ad Azure eseguendo az login.
  3. Installare l'estensione azure-iot quando richiesto al primo utilizzo. Per assicurarsi di usare la versione più recente dell'estensione, eseguire az extension update --name azure-iot.

Creare un account e un'istanza di Aggiornamento dispositivi

Azure portal

1. Nella portale di Azure cercare e selezionare Aggiornamento dispositivi per hub IoT.

2. Nella schermata Aggiornamento dispositivi per hub IoT selezionare Crea o Crea aggiornamento del dispositivo per hub IoT.

   

3. Nella scheda Informazioni di base della schermata Crea aggiornamento dispositivo specificare le informazioni seguenti:

   • Sottoscrizione: selezionare il nome della sottoscrizione di Azure per l'account di Aggiornamento dispositivi.
   • Gruppo di risorse: selezionare un gruppo di risorse esistente o crearne uno nuovo.
   • Nome: specificare un nome per l'account di Aggiornamento dispositivi.
   • Località: selezionare l'area di Azure per l'account. Per altre informazioni, vedere Prodotti disponibili in base all'area.
   • SKU: selezionare Standard.
   • Concedere l'accesso all'account
     • Se si dispone delle autorizzazioni Di proprietario o Amministratore accesso utenti nella sottoscrizione di Azure, è possibile selezionare la casella di controllo Assegna ruolo Amministratore aggiornamento dispositivi per assegnare a se stessi il ruolo Amministratore aggiornamento dispositivi per questo account.
     • Se queste autorizzazioni non sono disponibili, contattare l'amministratore dopo la creazione delle risorse per ottenere le autorizzazioni necessarie per lavorare con queste risorse. Per altre informazioni, vedere Configurare i ruoli di controllo di accesso per le risorse di Aggiornamento dispositivi.
   • Nome istanza: specificare un nome per l'istanza di Aggiornamento dispositivi.
   • hub IoT Nome: selezionare il hub IoT da collegare all'istanza di Aggiornamento dispositivi.
   • Concedere l'accesso a hub IoT: l'installazione di Aggiornamento dispositivi assegna automaticamente hub IoT ruolo Collaboratore dati all'entità servizio Aggiornamento dispositivi.

   

4. Facoltativamente, selezionare Avanti: Diagnostica o la scheda Diagnostica per configurare la registrazione diagnostica come parte del processo di creazione dell'istanza. L'abilitazione della diagnostica Microsoft consente a Microsoft di raccogliere, archiviare e analizzare i file di log di diagnostica dai dispositivi in caso di errore di aggiornamento.

   Se non si vuole abilitare la registrazione diagnostica ora, selezionare la scheda Rete .

5. Per configurare la registrazione diagnostica, nella scheda Diagnostica passare all'interruttore Registrazione diagnostica Microsoft abilitata.

6. Selezionare Seleziona account Archiviazione di Azure e quindi selezionare un account di archiviazione BLOB di Azure da collegare all'istanza di Aggiornamento dispositivi per la raccolta di log di diagnostica remota. I dettagli dell'account di archiviazione vengono aggiornati automaticamente.

   

7. Selezionare la scheda Rete o Avanti: Rete.

8. Nella scheda Rete è possibile scegliere gli endpoint usati dai dispositivi per connettersi all'istanza di Aggiornamento dispositivi. Per questo esempio, selezionare Accesso pubblico. L'accesso pubblico è accettabile a scopo di sviluppo e test, ma per gli scenari di produzione è consigliabile scegliere Accesso privato e configurare le connessioni endpoint private.

9. Seleziona Esamina.

   

10. Nella scheda Rivedi esaminare i dettagli e, al termine della convalida, selezionare Crea.

    

11. La schermata cambia per indicare che la distribuzione è in corso. Al termine della distribuzione, selezionare Vai alla risorsa.

Interfaccia della riga di comando di Azure

1. Eseguire az iot du account create per creare un nuovo account di Aggiornamento dispositivi.

   az iot du account create --resource-group <resource_group> --account <account_name> --location <region>
   

   Nel comando sostituire i segnaposto seguenti con le proprie informazioni:

   • <resource_group>: gruppo di risorse esistente nella sottoscrizione.

   • <account_name>: nome dell'account di Aggiornamento dispositivi.

   • <region>: area di Azure per l'account. Per altre informazioni, vedere Prodotti disponibili in base all'area. Se non si specifica un'area, il programma di installazione usa la posizione del gruppo di risorse.

     Nota

     L'account di Aggiornamento dispositivi non deve trovarsi nella stessa area dell'hub IoT, ma per ottenere prestazioni migliori dovrebbe essere geograficamente vicina.

2. Se richiesto, rispondere y per installare l'estensione dell'interfaccia della azure-iot riga di comando di Azure.

3. Un'istanza di Aggiornamento dispositivi è associata a un singolo hub IoT. Eseguire az iot du instance create per creare un'istanza di Aggiornamento dispositivi e specificare l'hub IoT da usare con l'istanza.

   az iot du instance create --account <account_name> --instance <instance_name> --iothub-ids <iothub_id>
   

   Nel comando sostituire i segnaposto seguenti con le proprie informazioni:

   • <account_name>: nome dell'account di Aggiornamento dispositivi per questa istanza.

   • <instance_name>: nome per questa istanza.

   • <iothub_id>: ID di risorsa completo per l'hub IoT da collegare a questa istanza, ad esempio "/subscriptions/<subscription_id>/resourceGroups/<resource_group_name>/providers/Microsoft.Devices/IotHubs/<iothub_name>".

     Per ottenere l'ID risorsa dell'hub IoT, eseguire az iot hub show ed eseguire una query per il valore ID.

     az iot hub show -n <iothub_name> --query id
     

È anche possibile configurare la registrazione diagnostica come parte del processo di creazione dell'istanza. Per archiviare i log di diagnostica, è necessario disporre di un account Archiviazione BLOB di Azure. Per altre informazioni, vedere Raccogliere in remoto i log di diagnostica dai dispositivi.

Passaggi successivi

L'installazione di Aggiornamento dispositivi assegna automaticamente hub IoT ruolo Collaboratore dati all'entità servizio Aggiornamento dispositivi. Questo ruolo consente solo a questa istanza di Aggiornamento dispositivi di connettersi e scrivere all'hub IoT collegato per eseguire operazioni di distribuzione degli aggiornamenti, gestione dei dispositivi e diagnostica.

Se si dispone delle autorizzazioni di amministratore di accesso utente o proprietario nella sottoscrizione di Azure, è possibile configurare il controllo di accesso fornendo agli utenti e alle applicazioni il livello di accesso necessario alle risorse di Aggiornamento dispositivi create. Se non si dispone delle autorizzazioni proprietario o amministratore accesso utenti, chiedere all'amministratore di Aggiornamento dispositivi di concedere l'accesso e le autorizzazioni necessarie per eseguire operazioni di aggiornamento, gestione e diagnostica di Aggiornamento dispositivi. Per altre informazioni, vedere Configurare i ruoli di controllo di accesso per le risorse di Aggiornamento dispositivi.

Contenuto correlato

• Account e istanze di Aggiornamento dispositivi
• Ruoli di controllo di accesso di Aggiornamento dispositivi