Tutorial: Criar uma implementação na cloud

  • Artigo

Este início rápido mostra como criar a sua primeira implementação de aplicação baseada na cloud. A implementação baseada na cloud fornece uma aplicação através de uma implementação atribuída a um grupo de dispositivos no produto de destino.

Neste tutorial, irá aprender a:

  • Criar um produto
  • Ativar a implementação baseada na cloud para o seu dispositivo
  • Criar a implementação
  • Implementação do acionador
  • Reativar o desenvolvimento e a depuração

Pré-requisitos

Criar um produto

Um produto identifica um modelo de dispositivo do Azure Sphere que executa uma função específica e executa uma aplicação específica.

Se ainda não tiver um produto, crie um com o comando az sphere product create .

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

Os nomes dos produtos têm de ser exclusivos no catálogo do Azure Sphere e não são sensíveis às maiúsculas e minúsculas. Se o nome contiver espaços, coloque-o entre aspas duplas nos comandos.

O comando az sphere product create cria automaticamente cinco grupos de dispositivos predefinidos para o novo produto: Desenvolvimento, Teste de Campo, Produção, Avaliação do SO de Teste de Campo e Avaliação do SO de Produção. Os grupos de dispositivos fornecem uma forma de organizar os seus dispositivos de acordo com a forma como os está a utilizar.

Ativar a implementação baseada na cloud para o seu dispositivo

Antes de testar o processo de implementação baseado na cloud, o dispositivo do Azure Sphere tem de estar pronto para aceitar atualizações de aplicações baseadas na cloud. Utilize o comando az sphere device enable-cloud-test para preparar o dispositivo:

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

Este comando:

  • Identifica o dispositivo como o modelo MyProduct, que foi criado no passo anterior.
  • Por predefinição, atribui o dispositivo ao grupo de dispositivos Teste de Campo, que permite atualizações de aplicações baseadas na cloud.
  • Desativa a capacidade de o SDK carregar aplicações para o dispositivo, para que apenas as aplicações baseadas na cloud possam ser carregadas.

Criar a implementação

Uma implementação é um conjunto de imagens que podem ser implementadas a partir do serviço cloud do Azure Sphere para os dispositivos dentro de um grupo de dispositivos específico.

Para criar uma implementação:

  1. Carregue o pacote de imagens para o catálogo do Azure Sphere com az sphere image add.

  2. Crie uma nova implementação para um grupo de dispositivos para as imagens carregadas com az sphere deployment create.

  3. Carregue o pacote de imagem:

     az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path <path-to-image>

    O resultado deve mostrar algo semelhante ao seguinte:

Uploading image from file 'Blink.imagepackage':
 --> Image ID:       <image-ID>
 --> Component ID:   <component-ID>
 --> Component name: 'Blink'
Removing temporary state for uploaded image.
Successfully uploaded image with ID '<image-id>' and name 'Blink' to component with ID '<component-id>'.

Irá utilizar o ID da Imagem no próximo passo.

  1. Criar uma nova implementação para um grupo de dispositivos:

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

  2. Para fornecer vários valores para --images introduzir uma lista de valores separados por espaços.

  3. Especifique o grupo de dispositivos Teste de Campo e o nome do produto que criou em Criar um produto.

  4. Substitua <image-ID> pelo ID de imagem do pacote de imagem que criou no Tutorial: Criar uma aplicação de alto nível.

  5. Para verificar se a implementação está configurada, utilize o comando az sphere image list-targeted .

Acionar a implementação

Os passos anteriores configuraram todos os elementos de implementação necessários. Para acionar imediatamente a transferência, prima o botão Repor no dispositivo do Azure Sphere. A aplicação deve ser transferida e iniciada dentro de vários minutos e deverá ver o LED a começar a piscar.

Para verificar se a aplicação foi instalada no seu dispositivo, utilize o comando az sphere device image list-installed . Poderá não ver os resultados da implementação imediatamente. Se a implementação não estiver listada quando executar o comando, tente novamente dentro de alguns minutos. O LED começará a piscar no dispositivo do Azure Sphere assim que a implementação for concluída.

Passos seguintes

À medida que continua a desenvolver e a testar aplicações, é provável que queira acarregá-las em sideload até estar pronto para implementá-las de forma mais abrangente. Para inverter o comando az sphere device enable-cloud-test e ativar o dispositivo para desenvolvimento e depuração, utilize az sphere device enable-development.

Avance para o artigo seguinte para saber como:

Criar uma aplicação com capacidade em tempo real

Se não estiver pronto para criar aplicações em tempo real, também poderá querer:

Resolução de problemas

Se encontrar problemas com as operações acima, veja a documentação de orientação de resolução de problemas.

Se encontrar problemas com as operações acima, veja a documentação de orientação de resolução de problemas.