Tutorial: criar uma implantação de nuvemTutorial: Create a cloud deployment

Este início rápido mostra como criar sua primeira implantação de aplicativo baseado em nuvem.This quickstart shows how to create your first cloud-based application deployment. A implantação baseada em nuvem fornece um aplicativo por meio de uma implantação atribuída a um grupo de dispositivos dentro do produto de destino.Cloud-based deployment delivers an application through a deployment assigned to a device group within the target product.

Neste tutorial, você aprenderá como:In this tutorial, you learn how to:

  • Crie um produtoCreate a product
  • Habilitar a implantação baseada em nuvem para seu dispositivoEnable cloud-based deployment for your device
  • Criar a implantaçãoCreate the deployment
  • Disparar a implantaçãoTrigger deployment
  • Reabilitar o desenvolvimento e a depuraçãoReenable development and debugging

Pré-requisitosPrerequisites

Crie um produtoCreate a product

Um produto identifica um modelo de Azure Sphere dispositivo que executa uma função específica e executa um aplicativo específico.A product identifies a model of Azure Sphere device that performs a specific function and runs a particular application.

Se você ainda não tiver um produto, crie um usando o 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"

Os nomes de produtos devem ser exclusivos em seu locatário Azure Sphere e não diferenciam maiúsculas de minúsculas.Product names must be unique within your Azure Sphere tenant and are not case sensitive. Se o nome contiver espaços, coloque-o entre aspas duplas em comandos, como no exemplo.If the name contain spaces, enclose it in double quotation marks in commands, as in the example.

O comando azsphere Product Create cria automaticamente cinco grupos de dispositivos padrão para o novo produto: desenvolvimento, teste de campo, produção, avaliação do so de teste de campo e avaliação do sistema operacional de produção.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. Os grupos de dispositivos fornecem uma maneira de organizar seus dispositivos de acordo com o modo como estão sendo usado.Device groups provide a way for you to organize your devices according to how you're using them.

Habilitar a implantação baseada em nuvem para seu dispositivoEnable cloud-based deployment for your device

Antes de testar o processo de implantação baseado em nuvem, seu dispositivo do Azure Sphere deve estar pronto para aceitar as atualizações de aplicativo baseado em nuvem.Before you test the cloud-based deployment process, your Azure Sphere device must be ready to accept cloud-based application updates. Use o comando azsphere do dispositivo Enable-Cloud-Test para preparar seu dispositivo:Use the azsphere device enable-cloud-test command to prepare your device:

azsphere device enable-cloud-test --product MyProduct

Esse comando:This command:

  • Identifica o dispositivo como o modelo MyProduct, que foi criado na etapa anterior.Identifies the device as the MyProduct model, which was created in the previous step.
  • Atribui o dispositivo ao grupo de dispositivos de teste de campo, que permite atualizações de aplicativos baseadas em nuvem.Assigns the device to the Field Test device group, which enables cloud-based application updates.
  • Desabilita a capacidade do SDK de carregar aplicativos no dispositivo, para que somente aplicativos baseados em nuvem possam ser carregados.Disables the ability for the SDK to load applications onto the device, so that only cloud-based applications can be loaded.

O Serviço de Segurança do Azure Sphere usa o grupo de dispositivos e o produto para determinar se deseja atualizar o aplicativo em um dispositivo.The Azure Sphere Security Service uses the device group and the product to determine whether to update the application on a device.

Criar a implantaçãoCreate the deployment

Uma implantação é um conjunto de imagens que podem ser implantadas do serviço de nuvem do Azure Sphere para os dispositivos em um determinado grupo de dispositivos.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.

Para criar uma implantação:To create a deployment:

  1. Carregue o pacote de imagem em seu locatário Azure Sphere usando a imagem azsphere adicionar.Upload the image package to your Azure Sphere tenant using azsphere image add.
  2. Crie uma nova implantação para um grupo de dispositivos para as imagens carregadas usando a criação de implantação de grupo de dispositivos azsphere.Create a new deployment for a device group for the uploaded images using azsphere device-group deployment create.
  1. Carregue o pacote de imagem:Upload the image package:
azsphere image add --image <path-to-image-package>
  1. Criar uma nova implantação para um grupo de dispositivos:Create a new deployment for a device group:
azsphere device-group deployment create --device-group <device-group-ID> --images <image-ID>

ouor

azsphere device-group deployment create --device-group '<product-name>/<device-group-name>' --images <image-ID>

Para fornecer vários valores para --images Inserir uma lista de valores separados por espaços.To provide multiple values for --images enter a list of values separated by spaces.

O --device-group parâmetro identifica o grupo de dispositivos.The --device-group parameter identifies the device group. A ID do grupo de dispositivos fornece um GUID, que identifica exclusivamente o grupo de dispositivos em todos os produtos.The device group ID supplies a GUID, which uniquely identifies the device group across all products. Como alternativa, você pode usar o nome do produto e o par de nomes do grupo de dispositivos no <product-name>/<device-group-name> formato.Alternatively, you can use the product name and device group name pair in the <product-name>/<device-group-name> format. Esse par de nomes identifica exclusivamente um grupo de dispositivos para um produto específico.This pair of names uniquely identifies a device group for a particular product.

Especifique o grupo de dispositivos de teste de campo e o nome do produto que você criou em criar um produto.Specify the Field Test device group and the name of the product that you created in Create a product.

Substitua <image-ID> pela ID de imagem do pacote de imagem que você criou no tutorial: criar um aplicativo de alto nível.Replace <image-ID> with the image ID of the image package that you created in Tutorial: Build a high-level application. Para Azure Sphere CLI, consulte criação de implantação do grupo de dispositivos azsphere para obter informações sobre como obter a ID da imagem.For Azure Sphere CLI, see azsphere device-group deployment create for information on getting the image ID.

Para verificar se a implantação está configurada, use o comando azsphere Device Image List-Targeted .To verify that the deployment is set up, use the azsphere device image list-targeted command.

Disparar a implantaçãoTrigger the deployment

As etapas anteriores configuram todos os elementos de implantação necessários.The previous steps set up all the required deployment elements. Para disparar o download imediatamente, pressione o botão Reiniciar no dispositivo do Azure Sphere.To trigger the download immediately, press the Reset button on the Azure Sphere device. O aplicativo deve ser baixado e iniciado em alguns minutos; o LED 1 deve começar a piscar.The application should download and start within several minutes, and you should see the LED start to blink.

Para verificar se o aplicativo foi instalado em seu dispositivo, use o comando azsphere Device Image List – installed .To verify that the application was installed on your device, use the azsphere device image list-installed command. Talvez você não veja os resultados da implantação imediatamente.You may not see the results of the deployment immediately. Se a implantação não estiver listada quando você executar o comando, tente novamente em alguns minutos.If the deployment is not listed when you run the command, try again in a few minutes. O LED começará a piscar no dispositivo de Azure Sphere assim que a implantação for concluída.The LED will begin to blink on the Azure Sphere device as soon as the deployment completes.

Reabilitar o desenvolvimento e a depuraçãoReenable development and debugging

Enquanto você continua desenvolvendo e testando aplicativos, provavelmente desejará realizar o sideload deles até estar pronto para implantá-los de maneira mais ampla.As you continue to develop and test applications, you will probably want to sideload them until you're ready to deploy them more broadly. Para reverter o comando device enable-cloud-test e habilitar o dispositivo para desenvolvimento e depuração, use 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

Esse comando atribui o dispositivo ao grupo de dispositivos de Desenvolvimento padrão para o produto e adiciona a funcionalidade do dispositivo para aceitar aplicativos para depuração.This command assigns the device to the default Development device group for its product and adds the device capability to accept applications for debugging. O grupo de dispositivos de desenvolvimento não permite o carregamento de aplicativos em nuvem.The Development device group does not enable cloud-loading of applications.

Próximas etapasNext steps

Prossiga para o próximo artigo para saber como...Advance to the next article to learn how to...

Se você não estiver pronto para criar aplicativos em tempo real, talvez também queira:If you aren't ready to build real-time applications, you might also want to: