Creare l'aggiornamento del dispositivo per le risorse di hub IoT

Per iniziare a usare Aggiornamento dispositivi, creare un account e un'istanza di Aggiornamento dispositivi e quindi impostare i ruoli di controllo di accesso.

Un account di Aggiornamento dispositivi è una risorsa nella sottoscrizione di Azure. Un'istanza di Aggiornamento dispositivi è un contenitore logico all'interno di un account associato a un hub IoT specifico. Un'istanza contiene aggiornamenti e distribuzioni associati all'hub IoT. È possibile creare più istanze all'interno di un account. Per altre informazioni, vedere Risorse di Aggiornamento dispositivi.

Prerequisiti

Azure portal

Un hub IoT. È necessario usare un livello S1 (Standard) o superiore.

Interfaccia della riga di comando di Azure

• Un hub IoT. È necessario usare un livello S1 (Standard) o superiore.

• Un ambiente dell'interfaccia della riga di comando di Azure:

  • Usare l'ambiente Bash in Azure Cloud Shell.

    

  • In alternativa, se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure

    • Accedere all'interfaccia della riga di comando di Azure usando il comando az login .

    • Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.

    • Quando richiesto, installare le estensioni dell'interfaccia della riga di comando di Azure al primo utilizzo. I comandi in questo articolo usano l'estensione azure-iot . Eseguire az extension update --name azure-iot per assicurarsi di usare la versione più recente dell'estensione.

Creare un account e un'istanza

Azure portal

1. Nella portale di Azure selezionare Crea una risorsa e cercare "Aggiornamento del dispositivo per hub IoT"

2. Selezionare Crea>aggiornamento del dispositivo per hub IoT

   

3. Nella scheda Informazioni di base specificare le informazioni seguenti per l'account e l'istanza di Aggiornamento dispositivi:

   • Sottoscrizione: sottoscrizione di Azure da associare all'account di Aggiornamento dispositivi.
   • Gruppo di risorse: gruppo di risorse esistente o nuovo.
   • Nome: nome dell'account.
   • Località: area di Azure in cui si troverà l'account. Per informazioni sulle aree che supportano l'aggiornamento dei dispositivi per hub IoT, vedere la pagina Prodotti di Azure per area.
   • Selezionare la casella per assegnare il ruolo di amministratore di Aggiornamento dispositivi a se stessi. È anche possibile usare i passaggi elencati nella sezione Configurare i ruoli di controllo di accesso per fornire una combinazione di ruoli a utenti e applicazioni per il livello di accesso corretto. Per gestire i ruoli, è necessario disporre delle autorizzazioni di proprietario o accesso utente Amministrazione istrator nella sottoscrizione.
   • Nome istanza: nome per l'istanza.
   • hub IoT Nome: selezionare il hub IoT da collegare all'istanza di Aggiornamento dispositivi
   • Selezionare la casella per concedere il diritto di accesso all'entità servizio Aggiornamento dispositivi di Azure nel hub IoT per configurare e gestire il servizio Aggiornamento dispositivi. È necessario disporre delle autorizzazioni appropriate per aggiungere l'accesso.

   Nota

   Se non è possibile concedere l'accesso all'entità servizio Aggiornamento dispositivi di Azure durante la creazione della risorsa, vedere Configurare il controllo di accesso per gli utenti e l'entità servizio Aggiornamento dispositivi di Azure . Se questo accesso non è impostato, non sarà possibile eseguire operazioni di distribuzione, gestione dei dispositivi e diagnostica. Altre informazioni sull'accesso dell'entità servizio di Aggiornamento dispositivi di Azure.

   

4. Selezionare Avanti: Diagnostica. L'abilitazione della diagnostica Microsoft concede a Microsoft l'autorizzazione per raccogliere, archiviare e analizzare i file di log di diagnostica dai dispositivi in caso di errore di aggiornamento. Per abilitare la raccolta di log remoti per la diagnostica, è necessario collegare l'istanza di Aggiornamento dispositivi all'account di archiviazione BLOB di Azure. Se si seleziona l'account Archiviazione di Azure, i dettagli di archiviazione verranno aggiornati automaticamente.

   

5. Nella scheda Rete continuare a creare l'account e l'istanza di Aggiornamento dispositivi. Scegliere gli endpoint che i dispositivi possono usare per connettersi all'istanza di Aggiornamento dispositivi. Accettare l'impostazione predefinita Accesso pubblico per questo esempio.

   

6. Seleziona Successivo: Rivedi e crea. Dopo la convalida selezionare Crea.

   

7. Si noterà che la distribuzione è in corso. Lo stato della distribuzione passerà a "completato" in pochi minuti. Al termine, selezionare Vai alla risorsa

Interfaccia della riga di comando di Azure

Usare il comando az iot du account create per creare un nuovo account di Aggiornamento dispositivi.

Sostituire i segnaposto seguenti con le proprie informazioni:

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

• <>account_name: un nome per l'account di Aggiornamento dispositivi.

• <area>: area di Azure in cui si troverà l'account. Per informazioni sulle aree che supportano l'aggiornamento dei dispositivi per hub IoT, vedere la pagina Prodotti di Azure per area. Se non viene specificata alcuna area, viene usata la posizione del gruppo di risorse.

  Nota

  L'account di Aggiornamento dispositivi non deve trovarsi nella stessa area degli hub IoT, ma per prestazioni migliori è consigliabile mantenerli geograficamente vicini.

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

Usare il comando az iot du instance create per creare un'istanza di Device Update.

Un'istanza di Device Update è associata a un singolo hub IoT. Selezionare l'hub IoT che verrà usato con Aggiornamento dispositivi. Quando si collega un hub IoT a un'istanza di Aggiornamento dispositivi, viene creato automaticamente un nuovo criterio di accesso condiviso per concedere le autorizzazioni di Aggiornamento dispositivi per funzionare con hub IoT (scrittura del Registro di sistema e connessione al servizio). Questo criterio garantisce che l'accesso sia limitato solo all'aggiornamento del dispositivo.

Sostituire i segnaposto seguenti con le proprie informazioni:

• <>account_name: nome dell'account di Aggiornamento dispositivi a cui verrà associata questa istanza.
• <>instance_name: nome per questa istanza.
• <>iothub_id: ID risorsa per l'hub IoT che verrà collegato a questa istanza. È possibile recuperare l'ID risorsa dell'hub IoT usando il comando az iot hub show ed eseguendo query sul valore ID: az iot hub show -n <iothub_name> --query id.

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

Suggerimento

Come parte del processo di creazione dell'istanza, è anche possibile configurare la registrazione diagnostica. Per altre informazioni, vedere Raccogliere in remoto i log di diagnostica dai dispositivi.

Passaggi successivi

Dopo aver creato le risorse di Aggiornamento dispositivi, configurare il controllo di accesso per gli utenti e l'entità servizio Aggiornamento dispositivi di Azure.

In alternativa, altre informazioni sugli account e le istanze di Aggiornamento dispositivi o sui ruoli di controllo di accesso di Aggiornamento dispositivi.