Aggiornamento dei dispositivi per la gestione delle risorse dell'hub IoT

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

Prerequisiti

Portale di Azure

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

Interfaccia della riga di comando di Azure

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

• Un ambiente CLI di Azure

  • Utilizza l'ambiente Bash in Azure Cloud Shell.

    

  • In alternativa, se si preferisce eseguire localmente i comandi di riferimento CLI, installare Azure CLI

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

    • Esegui az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, avviare 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 di Aggiornamento dispositivi

Portale di Azure

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

   

2. Selezionare Crea>aggiornamento del dispositivo per l'hub IoT

3. Nella scheda Informazioni di base specificare le informazioni seguenti per l'account 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 l'hub IoT, vedere la pagina Prodotti di Azure per area.

   Annotazioni

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

   

4. Facoltativamente, è possibile selezionare la casella per assegnare il ruolo di amministratore di Aggiornamento dispositivi a te stesso. È 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 proprietario o amministratore accesso utenti nella sottoscrizione.

5. Scegli Avanti: Istanza

   Un'istanza di Device Update è associata a un singolo hub IoT. Seleziona l'hub IoT che verrà utilizzato per l'Aggiornamento dei dispositivi. Quando si collega un hub IoT a un'istanza di Aggiornamento dispositivi, viene creato automaticamente un nuovo criterio di accesso condiviso che concede ad Aggiornamento dispositivi le autorizzazioni per lavorare con l'hub IoT (scrittura del registro e connessione al servizio). Questo criterio garantisce che l'accesso sia limitato solo all'aggiornamento del dispositivo.

6. Nella scheda Istanza specificare le informazioni seguenti per l'istanza di Aggiornamento dispositivi:

   • Nome: Un nome per la tua istanza.
   • Dettagli dell'hub IoT: selezionare un hub IoT da collegare a questa istanza.

   

7. Selezionare Avanti: Revisiona e crea. Dopo la convalida, selezionare Crea.

   

8. 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 device-update 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 l'hub IoT, vedere la pagina Prodotti di Azure per area. Se non viene specificata alcuna area, viene usata la posizione del gruppo di risorse.

  Annotazioni

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

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

Usare il comando az iot device-update instance create per creare un'istanza di aggiornamento dei dispositivi.

Un'istanza di Device Update è associata a un singolo hub IoT. Seleziona l'hub IoT che verrà utilizzato per l'Aggiornamento dei dispositivi. Quando si collega un hub IoT a un'istanza di Aggiornamento dispositivi, viene creato automaticamente un nuovo criterio di accesso condiviso che concede ad Aggiornamento dispositivi le autorizzazioni per lavorare con l'hub IoT (scrittura nel registro 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 device-update 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.

Configurare i ruoli di controllo di accesso per l'Aggiornamento dei dispositivi

Per consentire ad altri utenti di accedere a Device Update, è necessario concedere l'accesso a questa risorsa. È possibile ignorare questo passaggio se durante la creazione dell'account hai assegnato il ruolo di amministratore di Aggiornamento del dispositivo a te stesso e se non hai bisogno di concedere l'accesso ad altri utenti o applicazioni.

Portale di Azure

1. Nell'account di Aggiornamento dispositivi selezionare Controllo di accesso (IAM) dal menu di navigazione.

   

2. Selezionare Aggiungi assegnazioni di ruolo.

3. Nella scheda Ruolo selezionare un ruolo Aggiornamento dispositivi nelle opzioni disponibili:

   • Amministratore degli aggiornamenti dei dispositivi
   • Lettore di aggiornamenti per dispositivi
   • Amministratore del Contenuto Aggiornamento Dispositivo
   • Lettore di contenuti per l'aggiornamento del dispositivo
   • Amministratore delle distribuzioni di aggiornamenti dei dispositivi
   • Lettore delle distribuzioni di aggiornamenti dispositivo

   Per ulteriori informazioni, Scopri il Controllo degli accessi in base al ruolo nell'Aggiornamento dei dispositivi per l'Hub IoT.

   

4. Seleziona Avanti.

5. Nella scheda Membri selezionare gli utenti o i gruppi a cui si vuole assegnare il ruolo.

   

6. Selezionare Rivedi + assegna

7. Esaminare le nuove assegnazioni di ruolo e selezionare Rivedi e assegna di nuovo

8. È ora possibile usare Aggiornamento dispositivi dall'hub IoT

Interfaccia della riga di comando di Azure

Per l'assegnazione dell'accesso a Aggiornamento dispositivi sono disponibili i ruoli seguenti:

• Amministratore degli aggiornamenti dei dispositivi
• Lettore di aggiornamenti per dispositivi
• Amministratore del Contenuto Aggiornamento Dispositivo
• Lettore di contenuti per l'aggiornamento del dispositivo
• Amministratore delle distribuzioni di aggiornamenti dei dispositivi
• Lettore delle distribuzioni di aggiornamenti dispositivo

Per ulteriori informazioni, scopri il Controllo di accesso basato sui ruoli nell'Aggiornamento dei dispositivi per IoT Hub.

Usare il comando az role assignment create per configurare il controllo di accesso per il tuo account di Aggiornamento Dispositivi.

Sostituire i segnaposto seguenti con le proprie informazioni:

• <role>: Il ruolo di aggiornamento del dispositivo che stai assegnando.
• < >user_group: l'utente o il gruppo a cui si vuole assegnare il ruolo.
• < >account_id: ID risorsa per l'account di Aggiornamento dispositivi a cui l'utente o il gruppo otterrà l'accesso. È possibile recuperare l'ID risorsa usando il comando az iot device-update account show e interrogando per il valore dell'ID: az iot device-update account show -n <account_name> --query id.

az role assignment create --role '<role>' --assignee <user_group> --scope <account_id>

Configurare i ruoli di controllo di accesso per l'hub IoT

L'Aggiornamento dei dispositivi per IoT Hub comunica con l'IoT Hub per gestire le distribuzioni e gli aggiornamenti e ottenere informazioni sui dispositivi. Per consentire l'accesso, è necessario concedere all'entità servizio Aggiornamento dispositivi di Azure il ruolo di Collaboratore ai dati dell'hub IoT.

Portale di Azure

1. Nel portale di Azure, passare all'hub IoT connesso all'istanza di Aggiornamento dei dispositivi.
2. Selezionare Controllo di accesso (IAM) dal menu di spostamento.
3. Seleziona Aggiungi>Aggiungi assegnazione ruolo.
4. Nella scheda Ruolo selezionare Collaboratore dati hub IoT. Seleziona Avanti.
5. Per Assegna accesso a seleziona Utente, gruppo o principale del servizio.
6. Seleziona Membri e cercare 'Azure Device Update'
7. Selezionare Avanti>Rivedi + Assegna

Per verificare di aver impostato correttamente le autorizzazioni:

1. Nel portale di Azure, vai all'hub IoT collegato alla tua istanza di Aggiornamento dei dispositivi.
2. Selezionare Controllo di accesso (IAM) dal menu di spostamento.
3. Selezionare Controlla accesso.
4. Selezionare Utente, gruppo o entità servizio e cercare "Aggiornamento dispositivi di Azure"
5. Dopo aver fatto clic su Aggiornamento dispositivi di Azure, verificare che il ruolo Collaboratore dati dell'hub IoT sia elencato in Assegnazioni di ruolo

Interfaccia della riga di comando di Azure

Usare il comando az role assignment create per creare un'assegnazione di ruolo per l'entità servizio Aggiornamento dispositivi di Azure.

Sostituire <resource_id> con l'ID risorsa dell'hub IoT. È possibile recuperare l'ID risorsa usando il comando az iot hub show ed eseguendo query sul valore ID: az iot hub show -n <hub_name> --query id.

az role assignment create --role "IoT Hub Data Contributor" --assignee https://api.adu.microsoft.com/ --scope <resource_id>

Visualizzare ed eseguire query su account o istanze

È possibile visualizzare, ordinare e interrogare tutti gli account e le istanze di Aggiornamento dispositivi.

Portale di Azure

1. Per visualizzare tutti gli account di Aggiornamento dispositivi, usare il portale di Azure per cercare il servizio Aggiornamento dispositivi per hub IoT .

   • Usare il menu a discesa Raggruppamento per raggruppare l'account per sottoscrizione, gruppo di risorse, posizione e altre condizioni.
   • Selezionare Aggiungi filtro per filtrare l'elenco degli account in base a gruppo di risorse, posizione, tag e altre condizioni.

2. Per visualizzare tutte le istanze di un account, passare a tale account nel portale di Azure. Selezionare Istanze dalla sezione Gestione istanze del menu

   • Usare la casella di ricerca per filtrare le istanze.

Interfaccia della riga di comando di Azure

Per visualizzare tutti gli account di Aggiornamento dei dispositivi, usare il comando az iot device-update account list.

az iot device-update account list 

Per visualizzare tutte le istanze in un account, usare il comando az iot device-update instance list .

az iot device-update instance list --account <account_name>

Entrambi list i comandi supportano operazioni aggiuntive di raggruppamento e filtro. Usare l'argomento --query per trovare account o istanze in base a condizioni come i tag. Ad esempio: --query "[?tags.env == 'test']". Utilizzare l'argomento --output per formattare i risultati. Ad esempio: --output table.

Passaggi successivi

Provare ad aggiornare un dispositivo usando una delle esercitazioni rapide seguenti:

• Aggiornare un dispositivo IoT Edge simulato
• Aggiornare un dispositivo Raspberry Pi
• Aggiornare un agente del pacchetto Ubuntu Server 18.04 x64

Informazioni sull'account e sull'istanza di aggiornamento del dispositivo.

Informazioni sui ruoli di controllo di accesso degli aggiornamenti dei dispositivi