Pianificare e trasmettere processi (interfaccia della riga di comando di Azure)

Articolo
03/18/2023

Usare l'hub IoT per pianificare e tenere traccia dei processi che aggiornano milioni di dispositivi. Usare i processi per:

Aggiornare le proprietà desiderate
Aggiornare i tag
Richiamare metodi diretti

Concettualmente, un processo esegue il wrapping di una di queste azioni e tiene traccia dello stato di avanzamento dell'esecuzione su un set di dispositivi. Il set di dispositivi con cui un processo interagisce è definito da una query del dispositivo gemello. Grazie a un processo, ad esempio, un'app back-end può richiamare un metodo di riavvio in 10.000 dispositivi, specificato da una query di dispositivi gemelli e pianificato in un secondo momento. Tale applicazione può quindi tenere traccia dello stato di avanzamento quando ognuno di questi dispositivi riceve ed esegue il metodo di riavvio.

Altre informazioni su queste funzionalità sono disponibili in questi articoli:

Proprietà e dispositivi gemelli: introduzione ai dispositivi gemelli e Informazioni e uso dei dispositivi gemelli in hub IoT
Metodi diretti: guida per sviluppatori hub IoT - Metodi diretti

Nota

Le funzionalità descritte in questo articolo sono disponibili solo nel livello Standard dell'hub IoT. Per altre informazioni sui livelli di hub IoT standard e standard, vedere Scegliere il livello di hub IoT appropriato per la soluzione.

Questo articolo illustra come creare due sessioni dell'interfaccia della riga di comando di Azure:

Sessione che crea un dispositivo simulato. Il dispositivo simulato è configurato per restituire un codice di stato e un payload JSON quando viene richiamato qualsiasi metodo diretto.
Sessione che crea due processi pianificati. Il primo processo richiama un metodo diretto e il secondo processo aggiorna una proprietà del dispositivo gemello desiderata nel dispositivo simulato creato nell'altra sessione.

Prerequisiti

Interfaccia della riga di comando di Azure. È anche possibile eseguire i comandi in questo articolo usando azure Cloud Shell, una shell interattiva dell'interfaccia della riga di comando eseguita nel browser o in un'app, ad esempio Terminale Windows. Se si usa Cloud Shell, non è necessario installare alcun componente. Se si preferisce usare l'interfaccia della riga di comando in locale, questo articolo richiede l'interfaccia della riga di comando di Azure versione 2.36 o successiva. Eseguire az --version per trovare la versione. Per installare o aggiornare localmente l'interfaccia della riga di comando di Azure, vedere Installare l'interfaccia della riga di comando di Azure.
Un hub IoT nella sottoscrizione di Azure. Crearne uno con l'interfaccia della riga di comando o il portale di Azure.
Assicurarsi che la porta 8883 sia aperta nel firewall. L'esempio di dispositivo di questo articolo usa il protocollo MQTT, che comunica tramite la porta 8883. Questa porta potrebbe essere bloccata in alcuni ambienti di rete aziendali e didattici. Per altre informazioni e soluzioni alternative per questo problema, vedere Connettersi all'hub IoT (MQTT).

Preparare il Cloud Shell

Se si vuole usare il Cloud Shell di Azure, è necessario avviarlo e configurarlo. Se si usa l'interfaccia della riga di comando in locale, passare alla sezione Preparare due sessioni dell'interfaccia della riga di comando.

Selezionare l'icona Cloud Shell nell'intestazione di pagina nel portale di Azure.

Nota

Se è la prima volta che si usa Cloud Shell, viene richiesto di creare una risorsa di archiviazione necessaria per usare Cloud Shell. Selezionare una sottoscrizione per creare un account di archiviazione e una condivisione File di Microsoft Azure.
Usare il selettore di ambiente nella barra degli strumenti Cloud Shell per selezionare l'ambiente dell'interfaccia della riga di comando preferito. Questo articolo usa l'ambiente Bash . È anche possibile usare l'ambiente PowerShell .

Nota

Alcuni comandi richiedono sintassi o formattazione diversi negli ambienti Bash e PowerShell . Per altre informazioni, vedere Suggerimenti per l'uso dell'interfaccia della riga di comando di Azure.

Preparare due sessioni dell'interfaccia della riga di comando

È quindi necessario preparare due sessioni dell'interfaccia della riga di comando di Azure. Se si usa il Cloud Shell, eseguire queste sessioni in schede Cloud Shell separate. Se si usa un client dell'interfaccia della riga di comando locale, si eseguono istanze separate dell'interfaccia della riga di comando. Usare le sessioni separate dell'interfaccia della riga di comando per le attività seguenti:

La prima sessione simula un dispositivo IoT che comunica con l'hub IoT.
La seconda sessione pianifica i processi per il dispositivo simulato con l'hub IoT.

Nota

L'interfaccia della riga di comando di Azure richiede l'accesso all'account Azure. Se si usa il Cloud Shell, si accede automaticamente all'account Azure. Se si usa un client dell'interfaccia della riga di comando locale, è necessario accedere a ogni sessione dell'interfaccia della riga di comando. Tutte le comunicazioni tra la sessione della shell dell'interfaccia della riga di comando di Azure e l'hub IoT vengono autenticate e crittografate. Di conseguenza, questo articolo non richiede l'autenticazione aggiuntiva usata con un dispositivo reale, ad esempio una stringa di connessione. Per altre informazioni sull'accesso con l'interfaccia della riga di comando di Azure, vedere Accedere con l'interfaccia della riga di comando di Azure.

Nella prima sessione dell'interfaccia della riga di comando eseguire il comando az extension add . Il comando aggiunge l'estensione Microsoft Azure IoT per l'interfaccia della riga di comando di Azure alla shell dell'interfaccia della riga di comando. L'estensione aggiunge hub IoT, IoT Edge e comandi specifici del servizio Device Provisioning IoT all'interfaccia della riga di comando di Azure. Dopo aver installato l'estensione, non è necessario installarla di nuovo in alcuna sessione di Cloud Shell.
```
az extension add --name azure-iot
```
Nota

Questo articolo usa la versione più recente dell'estensione Azure IoT, denominata azure-iot. La versione legacy viene chiamata azure-cli-iot-ext. Deve essere installata solo una versione alla volta. È possibile usare il comando az extension list per convalidare le estensioni attualmente installate.

Usare az extension remove --name azure-cli-iot-ext per rimuovere la versione legacy dell'estensione.

Usare az extension add --name azure-iot per aggiungere la nuova versione dell'estensione.

Per visualizzare le estensioni installate, usare az extension list.
Aprire la seconda sessione dell'interfaccia della riga di comando. Se si usa il Cloud Shell in un browser, selezionare l'icona Apri nuova sessione sulla barra degli strumenti della prima sessione dell'interfaccia della riga di comando. Se si usa l'interfaccia della riga di comando in locale, aprire una seconda istanza dell'interfaccia della riga di comando.

Creare e simulare un dispositivo

In questa sezione viene creata un'identità del dispositivo per l'hub IoT nella prima sessione dell'interfaccia della riga di comando e quindi si simula un dispositivo usando tale identità del dispositivo. Il dispositivo simulato risponde ai processi pianificati nella seconda sessione dell'interfaccia della riga di comando.

Per creare e avviare un dispositivo simulato:

Nella prima sessione dell'interfaccia della riga di comando eseguire il comando az iot hub device-identity create , sostituendo i segnaposto seguenti con i valori corrispondenti. Questo comando crea l'identità del dispositivo per il dispositivo simulato.

{DeviceName}. Nome del dispositivo simulato.

{HubName}. Il nome dell'hub IoT.
```
az iot hub device-identity create --device-id {DeviceName} --hub-name {HubName} 
```
Nella prima sessione dell'interfaccia della riga di comando eseguire il comando az iot device simulate , sostituendo i segnaposto seguenti con i valori corrispondenti. Questo comando simula il dispositivo creato nel passaggio precedente. Il dispositivo simulato è configurato per restituire un codice di stato e un payload ogni volta che viene richiamato un metodo diretto.

{DeviceName}. Nome del dispositivo simulato.

{HubName}. Il nome dell'hub IoT.
```
az iot device simulate --device-id {DeviceName} --hub-name {HubName} \
                       --method-response-code 201 \
                       --method-response-payload '{"result":"Direct method successful"}'
```
Suggerimento

Per impostazione predefinita, il comando az iot device simulate invia 100 messaggi da dispositivo a cloud con un intervallo di 3 secondi tra i messaggi. La simulazione termina dopo l'invio di tutti i messaggi. Se si desidera che la simulazione venga eseguita più a lungo, è possibile usare il --msg-count parametro per specificare più messaggi o il --msg-interval parametro per specificare un intervallo più lungo tra i messaggi. È anche possibile eseguire di nuovo il comando per riavviare il dispositivo simulato.

Pianificare un processo per richiamare un metodo diretto

In questa sezione si pianifica un processo nella seconda sessione dell'interfaccia della riga di comando per richiamare un metodo diretto nel dispositivo simulato in esecuzione nella prima sessione dell'interfaccia della riga di comando.

Verificare che il dispositivo simulato nella prima sessione dell'interfaccia della riga di comando sia in esecuzione. In caso contrario, riavviarlo eseguendo di nuovo il comando az iot device simulate da Crea e simulare un dispositivo.
Nella seconda sessione dell'interfaccia della riga di comando eseguire il comando az iot hub job create , sostituendo i segnaposto seguenti con i valori corrispondenti. In questo esempio non esiste alcun metodo preesistente per il dispositivo. Il comando pianifica un processo che chiama un nome di metodo di esempio nel dispositivo simulato, fornendo un valore Null per il payload del metodo. Il metodo fornisce un codice di stato e un payload nella risposta.

{HubName}. Il nome dell'hub IoT.

{JobName}. Nome del processo pianificato. I nomi dei processi sono univoci, quindi scegliere un nome di processo diverso ogni volta che si esegue questo comando.

{NomeMetodo}. Nome del metodo diretto. Il dispositivo simulato non ha un metodo preesistente, quindi è possibile scegliere qualsiasi nome desiderato per questo comando.

{DeviceName}. Nome del dispositivo simulato.
```
az iot hub job create --hub-name {HubName} --job-id {JobName} \
                      --job-type scheduleDeviceMethod \
                      --method-name {MethodName} --method-payload 'null' \
                      --query-condition "deviceId = '{DeviceName}'"
```
Suggerimento

Quando si pianifica un comando az iot hub job create che richiama un metodo diretto, è necessario specificare i valori per i --method-name parametri facoltativi e --method-payload . Per i metodi diretti che non accettano un payload, specificare null per il --method-payload parametro .
Nella prima sessione dell'interfaccia della riga di comando verificare che l'output mostri la chiamata al metodo. Nello screenshot seguente sono stati usati SampleDevice eSampleMethod rispettivamente per i {DeviceName} segnaposto e {MethodName} nel comando dell'interfaccia della az iot hub job create riga di comando del passaggio precedente.

Pianificare un processo per aggiornare le proprietà di un dispositivo gemello

In questa sezione si pianifica un processo nella seconda sessione dell'interfaccia della riga di comando per aggiornare una proprietà del dispositivo gemello desiderata nel dispositivo simulato in esecuzione nella prima sessione dell'interfaccia della riga di comando.

Verificare che il dispositivo simulato nella prima sessione dell'interfaccia della riga di comando sia in esecuzione. In caso contrario, riavviarlo eseguendo di nuovo il comando az iot device simulate da Crea e simulare un dispositivo.
Nella seconda sessione dell'interfaccia della riga di comando eseguire il comando az iot hub job create , sostituendo i segnaposto seguenti con i valori corrispondenti. In questo esempio si pianifica un processo per impostare il valore della proprietà BuildingNo del gemello desiderato su 45 per il dispositivo simulato.

{HubName}. Il nome dell'hub IoT.

{JobName}. Nome del processo pianificato. I nomi dei processi sono univoci, quindi scegliere un nome di processo diverso ogni volta che si esegue questo comando.

{DeviceName}. Nome del dispositivo simulato.
```
az iot hub job create --hub-name {HubName} --job-id {JobName} \
                      --job-type scheduleUpdateTwin \
                      --twin-patch '{"properties":{"desired": {"BuildingNo": 45}}}' \
                      --query-condition "deviceId = '{DeviceName}'"
```
Nella prima sessione dell'interfaccia della riga di comando verificare che l'output mostri l'aggiornamento corretto per la proprietà del dispositivo gemello segnalato, a indicare che è stata aggiornata anche la proprietà del dispositivo gemello desiderato.

Passaggi successivi

In questo articolo è stata usata l'interfaccia della riga di comando di Azure per simulare un dispositivo e pianificare i processi per eseguire un metodo diretto e aggiornare le proprietà del dispositivo gemello per il dispositivo simulato.

Per continuare a esplorare i modelli di gestione dell'hub IoT e dei dispositivi, aggiornare un'immagine in Aggiornamento dispositivi per hub IoT di Azure esercitazione usando l'immagine di riferimento raspberry Pi 3 B+.