Creare una distribuzione

Per distribuire le applicazioni dal cloud, le immagini dell'applicazione vengono caricate nel catalogo Azure Sphere e viene creata una distribuzione per distribuire le immagini nei dispositivi Azure Sphere. Per creare una distribuzione, è necessario aver eseguito l'accesso ad Azure e avere le autorizzazioni appropriate per il ruolo di ricerca degli utenti. 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:

az sphere product create --resource-group MyResourceGroup --catalog MyCatalog --name MyProduct --description MyDescription

Sostituire <MyProduct> con un nome per il prodotto, ad esempio DW100. Per ulteriori informazioni su questo comando, vedi prodotto della sfera az .

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 az sphere device-group.

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 di abilitazione-sviluppo del dispositivo az sphere .

Per rimuovere la capacità, utilizza il dispositivo az sphere enable-cloud-test:

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog --device-group <device-group-ID>

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:

  1. Caricare il pacchetto di immagini:

    az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path <path-to-image> --regional-data-boundary <value>
    
  2. Creare una nuova distribuzione per un gruppo di dispositivi:

    az sphere deployment create --resource-group MyResourceGroup --catalog MyCatalog --product <product-name> --device-group <device-group-ID> --images <image-ID>
    

Per fornire più valori per --images immettere un elenco di valori separati da spazi.

Il --images parametro fornisce l'ID immagine del file del pacchetto di immagini per l'applicazione. L'immagine viene caricata nel catalogo 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.

Ad esempio (alcuni parametri rimossi per brevità):

az sphere image add --image my-app.imagepackage --regional-data-boundary "None"
az sphere deployment create --product "DW100" --device-group "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, utilizza di nuovo i comandi di aggiunta immagine sfera az e distribuzione di sfere az , come descritto nella sezione precedente, e specifica il percorso del file dell'applicazione aggiornato.