Creare una distribuzione

Per distribuire le applicazioni dal cloud, caricare le immagini dell'applicazione nel tenant di Azure Sphere e creare una distribuzione per distribuirle ai dispositivi Azure Sphere. Per creare una distribuzione, è necessario aver eseguito l'accesso ad Azure Sphere e disporre del ruolo di amministratore. Inoltre, i dispositivi devono essere preparati a ricevere le distribuzioni cloud.

Preparare i dispositivi

Prima che i dispositivi possano ricevere le applicazioni dal cloud, è necessario che dispongano di un prodotto e appartengano a un gruppo di dispositivi e che non abbiano la funzionalità AppDevelopment installata.

Se non è già stato creato un prodotto per i dispositivi, è necessario eseguire questa operazione prima di poter creare una distribuzione. Per creare un prodotto:

azsphere product create --name <product-name>

Sostituire <product-name> con un nome per il prodotto, ad esempio DW100. Per altre informazioni su questo comando, vedere prodotto azsphere.

Le distribuzioni sono destinate ai gruppi di dispositivi, quindi è anche necessario assegnare i dispositivi a un gruppo di dispositivi che abilita gli aggiornamenti cloud prima di poter ricevere le applicazioni distribuite. Per impostazione predefinita, ogni prodotto ha cinque gruppi di dispositivi: produzione, test sul campo, sviluppo, valutazione del sistema operativo test sul campo e valutazione del sistema operativo di produzione. È possibile usare uno di questi gruppi di dispositivi o crearne di personalizzati. Per scoprire se un gruppo di dispositivi supporta gli aggiornamenti cloud, usare azsphere device-group show.

I dispositivi devono essere inoltre preparati per il caricamento nel cloud, il che significa che non hanno la funzionalità appDevelopment. Quando vengono spediti dalla fabbrica, i dispositivi non dispongono di questa funzionalità. Tuttavia, se è stato usato un dispositivo per lo sviluppo di applicazioni, è probabile che questa funzionalità sia stata aggiunta con il comando azsphere device enable-development (chiamato azsphere device prep-debug nelle versioni di anteprima precedenti dell'SDK).

Per rimuovere la funzionalità, usare azsphere device enable-cloud-test:

azsphere device enable-cloud-test --device-group <device-group-ID> or '<product-name>/<device-group-name>'

azsphere device enable-cloud-test --productname <product-name> --devicegroupname <device-group-name>

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. Per altre informazioni, vedere Deployment Create.For more information, see deployment create.

Creare una distribuzione per un gruppo di dispositivi

Le distribuzioni possono contenere sia le configurazioni delle applicazioni sia quelle della scheda e vengono gestite allo stesso modo quando si crea una distribuzione. Le distribuzioni sono set di immagini da distribuire a tutti i dispositivi all'interno di un gruppo di dispositivi. Ogni distribuzione è collegata a un gruppo specifico di dispositivi all'interno di un prodotto specifico. Quando si crea la distribuzione, è necessario includere il nome del prodotto e il nome del gruppo di dispositivi (come illustrato nell'esempio seguente) o l'ID del gruppo di dispositivi.

Per creare una distribuzione:

azsphere device-group deployment create --devicegroupid <device-group-ID> --filepath <path-to-image-package>

azsphere device-group deployment create --devicegroupname <device-group-name> --productname <product-name> --filepath <path-to-image-package>

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.

Il --images parametro fornisce l'ID immagine del file del pacchetto immagine per l'applicazione. L'immagine viene caricata nel tenant corrente.

Il --regional-data-boundary parametro specifica il limite dei dati a livello di area per questa immagine. I valori consentiti sono EU e None. Il valore predefinito è None. Se non viene specificato alcun valore, verrà usato il valore predefinito.

Ad esempio:

azsphere image add --image my-app.imagepackage --regional-data-boundary "None"

azsphere device-group deployment create --device-group "DW100/Field Test" --images e3769536-dc4b-48d9-afd4-22ed321ba4bc

azsphere device-group deployment create --devicegroupname "Field Test" --productname DW100 --filepath my-app.imagepackage

Regole per una distribuzione valida

Per essere valida, una distribuzione deve seguire queste regole:

• Le dimensioni totali della distribuzione devono essere inferiori a 1 MiB.
• La distribuzione non può avere più di un file di configurazione della scheda.

Aggiornamento di una distribuzione

Per aggiornare una distribuzione, usare di nuovo i comandi azsphere image add e azsphere device-group deployment create, come descritto nella sezione precedente e specificare il percorso del file dell'applicazione aggiornato.