Tutorial: Criar uma implantação na nuvem

  • Artigo

Este início rápido mostra como criar sua primeira implantação de aplicativo baseada em nuvem. 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.

Neste tutorial, você aprenderá a:

  • Criar um produto
  • Habilitar a implantação baseada em nuvem para seu dispositivo
  • Criar a implantação
  • Implantação de gatilho
  • Habilitar novamente 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 um aplicativo específico.

Se você ainda não tiver um produto, crie um usando o comando azsphere product create .

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

Os nomes de produtos devem ser exclusivos no locatário do Azure Sphere e não são sensíveis a maiúsculas de minúsculas. Se o nome contiver espaços, inclua-o em aspas duplas em comandos, como no exemplo.

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 sistema operacional de teste de campo e avaliação do sistema operacional de produção. Os grupos de dispositivos fornecem uma maneira de organizar seus dispositivos de acordo com a forma como você os está usando.

Habilitar a implantação baseada em nuvem para seu dispositivo

Antes de testar o processo de implantação baseado em nuvem, seu dispositivo do Azure Sphere deve estar pronto para aceitar atualizações de aplicativo baseadas em nuvem. Use o comando azsphere device enable-cloud-test para preparar seu dispositivo:

azsphere device enable-cloud-test --product MyProduct

Este comando:

  • Identifica o dispositivo como o modelo MyProduct, que foi criado na etapa anterior.
  • Atribui o dispositivo ao grupo de dispositivos Teste de Campo, que permite atualizações de aplicativo baseadas em nuvem.
  • Desabilita a capacidade do SDK de carregar aplicativos no dispositivo, de modo que somente aplicativos baseados em nuvem possam ser carregados.

O Serviço de Segurança do Azure Sphere usa o grupo de dispositivos e o produto para determinar se o aplicativo deve ser atualizado em um dispositivo.

Criar a implantação

Uma implantação é um conjunto de imagens que pode ser implantada do serviço de nuvem do Azure Sphere para os dispositivos em um determinado grupo de dispositivos.

Para criar uma implantação:

  1. Carregue o pacote de imagem no locatário do Azure Sphere usando azsphere image add.
  2. Crie uma nova implantação para um grupo de dispositivos para as imagens carregadas usando azsphere device-group deployment create.
  1. Carregar o pacote de imagem:
azsphere image add --image <path-to-image>

A saída deve mostrar algo como o 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>'.

Você usará a ID da Imagem na próxima etapa.

  1. Criar uma nova implantação para um grupo de dispositivos:
azsphere device-group deployment create --device-group <device-group-ID> --images <image-ID>

Ou

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

Para o produto MyProduct e o teste de campo do grupo de dispositivos, você pode usar este segundo formulário para criar sua implantação facilmente:

azsphere device-group deployment create --device-group "MyProduct/Field Test" --images <image-ID>

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

O --device-group parâmetro identifica o grupo de dispositivos. A ID do grupo de dispositivos fornece um GUID, que identifica exclusivamente o grupo de dispositivos em todos os produtos. Como alternativa, você pode usar o nome do produto e o par de nomes do grupo de dispositivos no <formato nome> do produto/<dispositivo-grupo-nome> . Esse par de nomes identifica exclusivamente um grupo de dispositivos para um determinado produto.

Especifique o grupo de dispositivos teste de campo e o nome do produto que você criou em Criar um produto.

Substitua <a ID> da imagem pela ID da imagem do pacote de imagem que você criou no Tutorial: Criar um aplicativo de alto nível. Para a CLI do Azure Sphere, consulte 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 .

Disparar a implantação

As etapas anteriores configuram todos os elementos de implantação necessários. Para disparar o download imediatamente, pressione o botão Redefinir no dispositivo do Azure Sphere. O aplicativo deve baixar e iniciar dentro de vários minutos e você deve ver o LED começar a piscar.

Para verificar se o aplicativo foi instalado em seu dispositivo, use o comando instalado na lista de imagens do dispositivo do azsphere . Talvez você não veja os resultados da implantação imediatamente. Se a implantação não estiver listada quando você executar o comando, tente novamente em alguns minutos. O LED começará a piscar no dispositivo do Azure Sphere assim que a implantação for concluída.

Próximas etapas

À medida que você continua a desenvolver e testar aplicativos, provavelmente você vai querer ausustá-los até estar pronto para implantá-los de forma mais ampla. Para reverter o comando azsphere device enable-cloud-test e habilitar o dispositivo para desenvolvimento e depuração, use o dispositivo azsphere enable-development.

Avance para o próximo artigo para saber como:

Criar um aplicativo com capacidade em tempo real

Se você não estiver pronto para criar aplicativos em tempo real, também poderá querer:

Solucionar problemas

Se você encontrar problemas com as operações acima, consulte as diretrizes de solução de problemas.