Esercitazione: creare una distribuzione cloudTutorial: Create a cloud deployment

Questo avvio rapido illustra come creare la prima distribuzione dell'applicazione basata sul cloud.This quickstart shows how to create your first cloud-based application deployment. 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.Cloud-based deployment delivers an application through a deployment assigned to a device group within the target product.

In questa esercitazione verranno illustrate le procedure per:In this tutorial, you learn how to:

  • Creare un prodottoCreate a product
  • Abilitare la distribuzione basata sul cloud per il dispositivoEnable cloud-based deployment for your device
  • Creare la distribuzioneCreate the deployment
  • Attivare la distribuzioneTrigger deployment
  • Riabilita sviluppo e debugReenable development and debugging

PrerequisitiPrerequisites

Creare un prodottoCreate a product

Un prodotto identifica un modello di Azure Sphere dispositivo che esegue una funzione specifica ed esegue una particolare applicazione.A product identifies a model of Azure Sphere device that performs a specific function and runs a particular application.

Se non si dispone già di un prodotto, crearne uno usando il comando azsphere product create.If you do not already have a product, create one using the azsphere product create command.

azsphere product create --name MyProduct --description "My First Product"

I nomi dei prodotti devono essere univoci all'interno del tenant Azure Sphere e non fanno distinzione tra maiuscole e minuscoleProduct names must be unique within your Azure Sphere tenant and are not case sensitive. Se il nome contiene spazi, racchiuderlo tra virgolette doppie nei comandi, come nell'esempio.If the name contain spaces, enclose it in double quotation marks in commands, as in the example.

Il comando azsphere Product create crea automaticamente cinque gruppi di dispositivi predefiniti per il nuovo prodotto: sviluppo, test di campo, produzione, valutazione del sistema operativo di test dei campi e valutazione del sistema operativo di produzione.The azsphere product create command automatically creates five default device groups for the new product: Development, Field Test, Production, Field Test OS Evaluation, and Production OS Evaluation. I gruppi di dispositivi consentono di organizzare i dispositivi in base al modo in cui vengono utilizzati.Device groups provide a way for you to organize your devices according to how you're using them.

Abilitare la distribuzione basata sul cloud per il dispositivoEnable cloud-based deployment for your device

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.Before you test the cloud-based deployment process, your Azure Sphere device must be ready to accept cloud-based application updates. Usare il comando Enable-cloud-test del dispositivo azsphere per preparare il dispositivo:Use the azsphere device enable-cloud-test command to prepare your device:

azsphere device enable-cloud-test --productname "MyProduct"

Questo comando:This command:

  • Identifica il dispositivo come modello di prodotto, creato nel passaggio precedente.Identifies the device as the MyProduct model, which was created in the previous step.
  • Assegna il dispositivo al gruppo di dispositivi di test del campo, che Abilita gli aggiornamenti dell'applicazione basati sul cloud.Assigns the device to the Field Test device group, which enables cloud-based application updates.
  • Disabilita la possibilità per l'SDK di caricare le applicazioni nel dispositivo, in modo che sia possibile caricare solo le applicazioni basate sul cloud.Disables the ability for the SDK to load applications onto the device, so that only cloud-based applications can be loaded.

Il servizio di sicurezza di Azure Sphere usa il gruppo di dispositivi e il prodotto per determinare se aggiornare l'applicazione in un dispositivo.The Azure Sphere Security Service uses the device group and the product to determine whether to update the application on a device.

Creare la distribuzioneCreate the deployment

Una distribuzione è un set di immagini che possono essere distribuite dal servizio cloud Azure Sphere ai dispositivi in un particolare gruppo di dispositivi.A deployment is a set of images that can be deployed from the Azure Sphere cloud service to the devices within a particular device group. Usare il comando per la distribuzione del gruppo di dispositivi azsphere per creare una distribuzione:Use azsphere device-group deployment create command to create a deployment:

azsphere device-group deployment create --devicegroupname "Field Test" --productname "MyProduct" --filepath <image-package>

Specificare il gruppo di dispositivi "field test" e il nome del prodotto creato in creare un prodotto.Specify the "Field Test" device group and the name of the product that you created in Create a product.

Sostituire <image-package> con il percorso e il nome del pacchetto immagine creato in esercitazione: creare un'applicazione di alto livello.Replace <image-package> with the path and name of the image package that you created in Tutorial: Build a high-level application. Per l'interfaccia della riga di comando v2 beta, vedere la pagina relativa alla distribuzione del gruppo di dispositivi azsphere per informazioni su come ottenere l'ID immagine.For CLI v2 Beta, see azsphere device-group deployment create for information on getting the image ID.

Per verificare che la distribuzione sia configurata, usare il comando di destinazione elenco immagine dispositivo azsphere .To verify that the deployment is set up, use the azsphere device image list-targeted command.

Attivare la distribuzioneTrigger the deployment

I passaggi precedenti hanno configurato tutti gli elementi di distribuzione necessari.The previous steps set up all the required deployment elements. Per attivare immediatamente il download, premere il pulsante di Reset sul dispositivo di Azure Sphere.To trigger the download immediately, press the Reset button on the Azure Sphere device. L'applicazione dovrebbe scaricare e avviarsi entro alcuni minuti, mentre il LED dovrebbe iniziare a essere intermittente.The application should download and start within several minutes, and you should see the LED start to blink.

Per verificare che l'applicazione sia stata installata nel dispositivo, usare il comando azsphere elenco di immagini del dispositivo-installazione .To verify that the application was installed on your device, use the azsphere device image list-installed command. I risultati della distribuzione potrebbero non essere visibili immediatamente.You may not see the results of the deployment immediately. Se la distribuzione non viene elencata quando si esegue il comando, riprovare tra qualche minuto.If the deployment is not listed when you run the command, try again in a few minutes. Il LED inizierà a lampeggiare sul dispositivo Azure Sphere non appena viene completata la distribuzione.The LED will begin to blink on the Azure Sphere device as soon as the deployment completes.

Riabilita sviluppo e debugReenable development and debugging

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.As you continue to develop and test applications, you will probably want to sideload them until you're ready to deploy them more broadly. Per invertire il comando device enable-cloud-test e abilitare il dispositivo per lo sviluppo e il debug, usare azsphere device enable-development:To reverse the device enable-cloud-test command and enable the device for development and debugging, use azsphere device enable-development:

azsphere device enable-development

Questo comando assegna il dispositivo al gruppo di dispositivi di sviluppo predefinito per il prodotto e aggiunge la funzionalità per accettare applicazioni per il debug.This command assigns the device to the default Development device group for its product and adds the device capability to accept applications for debugging. Il gruppo di dispositivi di sviluppo non consente il caricamento nel cloud delle applicazioni.The Development device group does not enable cloud-loading of applications.

Passaggi successiviNext steps

Passare all'articolo successivo per informazioni su come...Advance to the next article to learn how to...

Se non si è pronti per compilare applicazioni in tempo reale, potrebbe essere necessario:If you aren't ready to build real-time applications, you might also want to: