Esercitazione: Creare una distribuzione cloud
Importante
Questa è la documentazione di Azure Sphere (legacy). Azure Sphere (legacy) viene ritirato il 27 settembre 2027 e gli utenti devono eseguire la migrazione ad Azure Sphere (integrato) entro questo periodo. Usare il selettore di versione posizionato sopra il sommario per visualizzare la documentazione di Azure Sphere (integrata).
Questo avvio rapido illustra come creare la prima distribuzione dell'applicazione basata sul cloud. Con la distribuzione basata sul cloud viene distribuita un'applicazione tramite una distribuzione assegnata a un gruppo di dispositivi all'interno del prodotto di destinazione.
In questa esercitazione apprenderai a:
- Creare un prodotto
- Abilitare la distribuzione basata sul cloud per il dispositivo
- Creare la distribuzione
- Attivare la distribuzione
- Riabilitare lo sviluppo e il debug
Prerequisiti
- Il dispositivo Azure Sphere è connesso al computer e a Internet.
- L'esercitazione è stata completata: Creare un'applicazione di alto livello e avere un file di pacchetto immagine per l'applicazione.
Creare un prodotto
Un prodotto identifica un modello di dispositivo Azure Sphere che esegue una funzione specifica ed esegue una determinata applicazione.
Se non si dispone già di un prodotto, crearne uno usando il comando azsphere product create.
azsphere product create --name MyProduct --description "My First Product"
I nomi dei prodotti devono essere univoci all'interno del tenant di Azure Sphere e non fanno distinzione tra maiuscole e minuscole. Se il nome contiene spazi, racchiuderlo tra virgolette doppie nei comandi, come nell'esempio.
Il comando azsphere product create crea automaticamente cinque gruppi di dispositivi predefiniti per il nuovo prodotto: Sviluppo, Test campo, Produzione, Valutazione del sistema operativo test sul campo e Valutazione del sistema operativo di produzione. I gruppi di dispositivi consentono di organizzare i dispositivi in base al modo in cui vengono usati.
Abilitare la distribuzione basata sul cloud per il dispositivo
Prima di testare il processo di distribuzione basato sul cloud, il dispositivo di Azure Sphere deve essere pronto ad accettare gli aggiornamenti dell'applicazione basati sul cloud. Usare il comando azsphere device enable-cloud-test per preparare il dispositivo:
- Interfaccia della riga di comando di Azure Sphere
- Interfaccia della riga di comando classica di Azure Sphere
azsphere device enable-cloud-test --product MyProduct
Questo comando:
- Identifica il dispositivo come modello MyProduct, creato nel passaggio precedente.
- Assegna il dispositivo al gruppo di dispositivi Field Test, che abilita gli aggiornamenti delle applicazioni basate sul cloud.
- Disabilita la possibilità per l'SDK di caricare le applicazioni nel dispositivo, in modo che solo le applicazioni basate sul cloud possano essere caricate.
Il servizio di sicurezza di Azure Sphere usa il gruppo di dispositivi e il prodotto per determinare se aggiornare l'applicazione in un dispositivo.
Creare la distribuzione
Una distribuzione è un set di immagini che possono essere distribuite dal servizio cloud Azure Sphere ai dispositivi in un particolare gruppo di dispositivi.
Per creare una distribuzione:
- Caricare il pacchetto immagine nel tenant di Azure Sphere usando azsphere image add.
- Creare una nuova distribuzione per un gruppo di dispositivi per le immagini caricate usando azsphere device-group deployment create.
- Interfaccia della riga di comando di Azure Sphere
- Interfaccia della riga di comando classica di Azure Sphere
- Caricare il pacchetto immagine:
azsphere image add --image <path-to-image>
L'output dovrebbe essere simile al seguente:
Uploading image from file 'Blink.imagepackage':
--> Image ID: <image-ID>
--> Component ID: <component-ID>
--> Component name: 'Blink'
Removing temporary state for uploaded image.
Successfully uploaded image with ID '<image-id>' and name 'Blink' to component with ID '<component-id>'.
L'ID immagine verrà usato nel passaggio successivo.
- Creare una nuova distribuzione per un gruppo di dispositivi:
azsphere device-group deployment create --device-group <device-group-ID> --images <image-ID>
or
azsphere device-group deployment create --device-group '<product-name>/<device-group-name>' --images <image-ID>
Per il prodotto MyProduct e device group Field Test, è possibile usare questo secondo modulo per creare facilmente la distribuzione:
azsphere device-group deployment create --device-group "MyProduct/Field Test" --images <image-ID>
Per specificare più valori per --images immettere un elenco di valori separati da spazi.
Il --device-group parametro identifica il gruppo di dispositivi. L'ID del gruppo di dispositivi fornisce un GUID che identifica in modo univoco il gruppo di dispositivi in tutti i prodotti. In alternativa, è possibile usare la coppia nome prodotto e nome gruppo di dispositivi nel <formato product-name>/<device-group-name> . Questa coppia di nomi identifica in modo univoco un gruppo di dispositivi per un prodotto specifico.
Specificare il gruppo di dispositivi Field Test e il nome del prodotto creato in Creare un prodotto.
Sostituire <image-ID> con l'ID immagine del pacchetto immagine creato in Esercitazione: Creare un'applicazione di alto livello. Per l'interfaccia della riga di comando di Azure Sphere, vedere azsphere device-group deployment create per informazioni su come ottenere l'ID immagine.
Per verificare che la distribuzione sia configurata, usare il comando azsphere device image list-targeted.
Attivare la distribuzione
I passaggi precedenti hanno configurato tutti gli elementi di distribuzione necessari. Per attivare immediatamente il download, premere il pulsante di Reset sul dispositivo di Azure Sphere. L'applicazione dovrebbe scaricare e avviarsi entro alcuni minuti, mentre il LED dovrebbe iniziare a essere intermittente.
Per verificare che l'applicazione sia stata installata nel dispositivo, usare il comando azsphere device image list-installed. I risultati della distribuzione potrebbero non essere visibili immediatamente. Se la distribuzione non è elencata quando si esegue il comando, riprovare in pochi minuti. Il LED inizierà a lampeggiare sul dispositivo Azure Sphere non appena viene completata la distribuzione.
Passaggi successivi
Quando si continua a sviluppare e testare applicazioni, è probabile che si desideri trasferirle in locale fino a quando non si è pronti per una distribuzione più ampia. Per invertire il comando azsphere device enable-cloud-test e abilitare il dispositivo per lo sviluppo e il debug, usare azsphere device enable-development.
Passare all'articolo successivo per informazioni su come:
Se non si è pronti per compilare applicazioni in tempo reale, è anche possibile:
- Esplorare gli esempi di Azure Sphere su GitHub
- Altre informazioni sulle nozioni di base sulla distribuzione di Azure Sphere
Risoluzione dei problemi
Se si verificano problemi con le operazioni precedenti, vedere le indicazioni per la risoluzione dei problemi.