Tutorial: Criar uma implantação na nuvem

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

• Seu dispositivo do Azure Sphere está conectado ao computador e à Internet.
• Você concluiu o Tutorial: crie um aplicativo de alto nível e tenha um arquivo de pacote de imagem para seu aplicativo.

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 az sphere product create .

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

Os nomes de produtos devem ser exclusivos no catálogo do Azure Sphere e não são sensíveis a casos. Se o nome contiver espaços, inclua-o em aspas duplas em comandos.

O comando az sphere 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 az sphere device enable-cloud-test para preparar seu 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 na etapa anterior.
• Por padrão, atribui o dispositivo ao grupo de dispositivos Teste de Campo, que habilita 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.

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 catálogo do Azure Sphere usando az sphere image add.

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

3. Carregar o pacote de imagem:

    az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path <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:

   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 inserir uma lista de valores separados por espaços.

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

4. Substitua <image-ID> pela ID de imagem do pacote de imagem que você criou no Tutorial: Criar um aplicativo de alto nível.

5. Para verificar se a implantação está configurada, use o comando az sphere 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 az sphere . 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 az sphere device enable-cloud-test e habilitar o dispositivo para desenvolvimento e depuração, use az sphere device enable-development.

Avance para o próximo artigo para saber como:

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

• Explorar os exemplos do Azure Sphere no GitHub
• Saiba mais sobre as noções básicas de implantação do Azure Sphere

Solucionar problemas

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

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