Tutorial: Criar uma implantação na nuvem
Importante
Esta é a documentação do Azure Sphere (Legado). O Azure Sphere (Legado) será desativado em 27 de setembro de 2027 e os usuários devem migrar para o Azure Sphere (Integrado) até esse momento. Use o seletor de versão localizado acima do sumário para exibir a documentação do Azure Sphere (Integrado).
Este guia de início rápido mostra como criar sua primeira implantação de aplicativo baseado 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, irá aprender a:
- Criar um produto
- Habilite a implantação baseada em nuvem para seu dispositivo
- Criar a implantação
- Acionar a implantação
- Reativar o desenvolvimento e a depuração
Pré-requisitos
- Seu dispositivo Azure Sphere está conectado ao seu 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 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 produto devem ser exclusivos em seu locatário do Azure Sphere e não diferenciam maiúsculas de minúsculas. Se o nome contiver espaços, coloque-o entre aspas duplas nos 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 forma de organizar os seus dispositivos de acordo com a forma como os está a utilizar.
Habilite a implantação baseada em nuvem para seu dispositivo
Antes de testar o processo de implantação baseado em nuvem, seu dispositivo Azure Sphere deve estar pronto para aceitar atualizações de aplicativos baseados 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 Field Test, que permite atualizações de aplicativos baseados em nuvem.
- Desabilita a capacidade do SDK de carregar aplicativos no dispositivo, para que apenas 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 podem ser implantadas do serviço de nuvem do Azure Sphere para os dispositivos dentro de um grupo de dispositivos específico.
Para criar uma implantação:
- Carregue o pacote de imagem para seu locatário do Azure Sphere usando azsphere image add.
- Crie uma nova implantação para um grupo de dispositivos para as imagens carregadas usando azsphere device-group deployment create.
- Carregue o pacote de imagens:
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á o ID da imagem na próxima etapa.
- Crie 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 , insira uma lista de valores separados por espaços.
O --device-group parâmetro identifica o grupo de dispositivos. O 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 product-name>/<device-group-name> . Este 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 <image-ID> pelo ID de imagem do pacote de imagem que você criou em Tutorial: Criar um aplicativo de alto nível. Para a CLI do Azure Sphere, consulte azsphere device-group deployment create para obter informações sobre como obter a ID da imagem.
Para verificar se a implantação está configurada, use o comando azsphere device image list-targeted.
Acionar a implantação
As etapas anteriores configuram todos os elementos de implantação necessários. Para acionar o download imediatamente, pressione o botão Redefinir no dispositivo Azure Sphere. O aplicativo deve baixar e iniciar dentro de alguns minutos, e você deve ver o LED começar a piscar.
Para verificar se o aplicativo foi instalado no seu dispositivo, use o comando azsphere device image list-installed. Você pode não ver 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 Azure Sphere assim que a implantação for concluída.
Próximos passos
À medida que você continua a desenvolver e testar aplicativos, provavelmente desejará fazer sideload deles 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 azsphere device enable-development.
Avance para o próximo artigo para saber como:
Se você não estiver pronto para criar aplicativos em tempo real, talvez também queira:
- Explore os exemplos do Azure Sphere no GitHub
- Saiba mais sobre as noções básicas de implantação do Azure Sphere
Resolver problemas
Se você encontrar problemas com as operações acima, consulte as diretrizes de solução de problemas.