Condividi tramite

Creare una distribuzione cloud

  • Articolo

Per distribuire le applicazioni dal cloud, caricare le immagini dell'applicazione in un catalogo di Azure Sphere e creare una distribuzione per distribuire immagini 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.

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.

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 eseguire questa operazione prima di poter creare una distribuzione. Per creare un prodotto:

Usare il portale

  1. Accedere al portale di Azure. Per individuare il servizio Azure Sphere, nella barra di ricerca superiore immettere e selezionare Azure Sphere. Viene visualizzata la pagina Azure Sphere.
  2. Selezionare il catalogo in cui si vuole creare una distribuzione. Verificare che il filtro della sottoscrizione sia impostato in modo appropriato per visualizzare tutti i cataloghi e i gruppi di risorse.
  3. Selezionare Gestisci>prodotti dal lato sinistro della pagina del catalogo.
  4. Fare clic su + Crea nella parte superiore della pagina del catalogo.
  5. Immettere un nome e una descrizione per il prodotto. Contrassegnare la casella di controllo per indicare se devono essere creati gruppi di dispositivi predefiniti. Se contrassegnato, verranno creati i gruppi di dispositivi predefiniti seguenti: Sviluppo, Test campo, Valutazione del sistema operativo test sul campo, Produzione, Valutazione del sistema operativo di produzione.
  6. Infine, fare clic su Crea nella parte inferiore della pagina.

Se si sceglie di non creare gruppi di dispositivi predefiniti, è necessario creare manualmente un gruppo di dispositivi e associarlo al prodotto:

  1. Selezionare Gestisci>gruppi di dispositivi a sinistra della pagina.
  2. Fare clic su + Crea nella parte superiore della pagina.
  3. Selezionare il prodotto creato nei passaggi precedenti.
  4. Immettere un nome per il gruppo di dispositivi e una breve descrizione.
  5. Selezionare il feed del sistema operativo per il gruppo di dispositivi. Il feed RetailEval riceve versioni non definitive del sistema operativo prima del feed Retail . RetailEval non è quindi consigliato per i dispositivi di produzione. Selezionare il feed Retail per i dispositivi di produzione.
  6. Selezionare i criteri di aggiornamento per il gruppo di dispositivi. UpdateAll indica che i dispositivi nel gruppo eseguiranno gli aggiornamenti del sistema operativo e dell'applicazione, se disponibili. No3rdPartyAppUpdates indica che i dispositivi nel gruppo accettano solo gli aggiornamenti del sistema operativo.

Usare la CLI

Suggerimento

È consigliabile configurare i valori predefiniti per i parametri di sottoscrizione, gruppo di risorse e catalogo. Ciò consente di ridurre la ridondanza e di ridurre notevolmente la sintassi dei comandi dell'interfaccia della riga di comando.

A meno che non sia stata impostata la sottoscrizione attiva, il --subscription parametro sarà necessario per tutti i comandi. È possibile impostare la sottoscrizione attiva usando il comando az account set --subscription <subscription-name>.

Usare il comando az sphere product create.

az sphere product create --resource-group MyResourceGroup --catalog MyCatalog  --name MyProduct --description "My new product"

Usare il az sphere device-group create comando per creare un gruppo di dispositivi e associarlo al prodotto.

az sphere device-group create --resource-group MyResourceGroup --catalog MyCatalog   --name "My Development Device Group" --product MyProduct -d "development device group for MyProduct"

Le distribuzioni hanno come destinazione i gruppi di dispositivi. I dispositivi dovranno essere assegnati a un gruppo di dispositivi con aggiornamenti cloud abilitati prima che i dispositivi possano ricevere 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 determinare se un gruppo di dispositivi accetta gli aggiornamenti cloud, usare az sphere device-group show.

I dispositivi all'interno del gruppo di dispositivi devono essere preparati per il caricamento nel cloud. Ciò significa che non devono avere la funzionalità appDevelopment . I dispositivi spediti direttamente dalla factory in genere non hanno la funzionalità appDevelopment . La funzionalità viene aggiunta quando viene usato il comando az sphere device enable-development.

Per rimuovere la funzionalità appDevelopment , usare az sphere device enable-cloud-test:

Usare la CLI

Usare il comando az sphere device enable-cloud-test.

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

Creare una distribuzione per un gruppo di dispositivi

Le distribuzioni sono set di immagini da distribuire a tutti i dispositivi all'interno di un gruppo di dispositivi. Una distribuzione può contenere sia le applicazioni che le configurazioni della scheda. 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.

Usare il portale

  1. Accedere al portale di Azure. Per individuare il servizio Azure Sphere, nella barra di ricerca superiore immettere e selezionare Azure Sphere. Viene visualizzata la pagina Azure Sphere.
  2. Selezionare il catalogo in cui si vuole creare una distribuzione. Verificare che il filtro della sottoscrizione sia impostato in modo appropriato per visualizzare tutti i cataloghi e i gruppi di risorse.
  3. Selezionare Gestisci>prodotti sul lato sinistro della pagina.
  4. La pagina successiva mostra una tabella con tutti i prodotti creati elencati. Selezionare il prodotto per cui si vuole creare una distribuzione.
  5. Una tabella mostra tutti i gruppi di dispositivi associati al prodotto scelto. Selezionare il gruppo di dispositivi per cui si vuole creare una distribuzione.
  6. Selezionare la scheda Distribuzioni .
  7. Fare clic su +Crea sotto la scheda Distribuzioni.
  8. Nella visualizzazione visualizzata selezionare e usare l'immagine esistente oppure fare clic su +Aggiungi per caricare una nuova immagine.
  9. Nella parte inferiore della visualizzazione fare clic su +Crea.

Usare la CLI

Completare i passaggi descritti in Preparare i dispositivi prima di procedere, quindi:

  1. Caricare un pacchetto immagine, prendendo nota dell'imageId restituito dal comando :

    az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path myImage.imagepackage

  2. Usare il az sphere image-package show comando per ottenere l'imageId del pacchetto immagine:

    az sphere image-package show --image-package myImage.imagepackage

The command returns information about the image package, including the **imageId**:

```azurecli
Image package metadata:
  Section: Identity
   Image Type: Application
   Component ID: 1689d8b2-c835-2e27-27ad-e894d6d15fa9
   Image ID: be3f90bd-849f-487e-a170-7fe1ff03fe2d
  Section: Signature
   Signing Type: ECDsa256
   Cert: a8d5cc6958f48710140d7a26160fc1cfc31f5dfO
  Section: Debug 
   Image Name:       myImage
   Built On (UTC):   02/21/22 16:21:58
   Built On (Local): 02/21/22 16:21:58
  Section: Temporary Image

  3. Creare una nuova distribuzione per un gruppo di dispositivi:

    az sphere deployment create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --images <imageId returned from previous step>

È possibile fornire più immagini al --images parametro usando un elenco separato da spazi di ID immagine.

Per elencare i gruppi di dispositivi in un catalogo, usare az sphere device-group list.

Per elencare tutte le immagini in un catalogo, usare az sphere image list.

Aggiornamento di una distribuzione

Non è possibile aggiornare una distribuzione. È invece necessario creare una nuova distribuzione. Ripetere i passaggi della sezione precedente, aggiornando i parametri dove necessario.