Creare una distribuzione
Per distribuire le applicazioni dal cloud, è necessario caricare le immagini dell'applicazione nel tenant azure sphere e creare una distribuzione per distribuire le immagini ai dispositivi Azure Sphere. Per creare una distribuzione, devi avere effettuato l'accesso ad Azure Sphere e avere il ruolo di amministratore. Inoltre, i dispositivi devono essere pronti a ricevere distribuzioni cloud.
Nota
Ogni componente di una distribuzione deve avere un GUID univoco. Se si basa l'applicazione su un esempio di Azure Sphere, ricordarsi di creare un GUID univoco per l'applicazione prima di creare una distribuzione per evitare possibili conflitti.
Preparare i dispositivi
Prima che i dispositivi possano ricevere applicazioni dal cloud, devono avere un prodotto e appartenere a un gruppo di dispositivi e non possono avere la funzionalità AppDevelopment installata.
Se non è già stato creato un prodotto per i dispositivi, è necessario farlo prima di poter creare una distribuzione. Per creare un prodotto:
azsphere product create --name <product-name>
Sostituire <il nome> del prodotto con un nome per il prodotto, ad esempio DW100. Per altre informazioni su questo comando, vedere prodotto azsfera .
Le distribuzioni sono destinate ai gruppi di dispositivi, quindi dovrai anche assegnare i tuoi dispositivi a un gruppo di dispositivi che abilita gli aggiornamenti cloud prima che possano 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 uno personalizzato. Per scoprire se un gruppo di dispositivi accetta aggiornamenti cloud, usa la presentazione di gruppi di dispositivi azsfera.
I dispositivi devono anche essere preparati per il caricamento cloud, il che significa che non hanno la funzionalità appSviluppo . Quando viene spedito dalla fabbrica, i dispositivi non dispongono di questa funzionalità. Tuttavia, se hai usato un dispositivo per lo sviluppo di applicazioni, probabilmente hai aggiunto questa funzionalità con il comando abilitare-sviluppo del dispositivo azsfera (denominato prep-debug del dispositivo azsfera nelle versioni di anteprima precedenti dell'SDK).
Per rimuovere la funzionalità, usare il dispositivo azsfera enable-cloud-test:
azsphere device enable-cloud-test --device-group <device-group-ID> or '<product-name>/<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, puoi usare la coppia nome prodotto e nome gruppo di dispositivi nel <formato nome-prodotto>/<nome-gruppo-dispositivo> . Questa coppia di nomi identifica in modo univoco un gruppo di dispositivi per un determinato prodotto. Per altre informazioni, vedere Creazione della distribuzione.
Creare una distribuzione per un gruppo di dispositivi
Le distribuzioni possono contenere sia le configurazioni delle applicazioni che delle bacheche ed entrambe 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 di dispositivi specifico all'interno di un prodotto specifico. È 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 quando si crea la distribuzione.
Per creare una distribuzione:
Caricare il pacchetto di immagini:
azsphere image add --image <path-to-image> --regional-data-boundary <value>Creare una nuova distribuzione per un gruppo di dispositivi:
azsphere device-group deployment create --device-group <device-group-ID> --images <image-ID>O
azsphere device-group deployment create '<product-name>/<device-group-name>' --images <image-ID>
Per fornire 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, puoi usare la coppia nome prodotto e nome gruppo di dispositivi nel <formato nome-prodotto>/<nome-gruppo-dispositivo> . Questa coppia di nomi identifica in modo univoco un gruppo di dispositivi per un determinato prodotto.
Il --images parametro fornisce l'ID immagine del file del pacchetto di immagini per l'applicazione. L'immagine viene caricata nel tenant corrente.
Il --regional-data-boundary parametro specifica il limite dei dati internazionali 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.
Per 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
Regole per una distribuzione valida
Per essere valida, una distribuzione deve seguire queste regole:
- La dimensione totale della distribuzione deve essere inferiore a 1 MiB.
- La distribuzione non può avere più di un file di configurazione della bacheca.
Aggiornare una distribuzione
Per aggiornare una distribuzione, usare di nuovo i comandi per la creazione di immagini azsfera e gruppi di dispositivi azsfera , come descritto nella sezione precedente, e specificare il percorso del file di applicazione aggiornato.