Tutorial: Criar uma implantação na nuvem
Importante
Esta é a documentação do Azure Sphere (herdado). O Azure Sphere (herdado) 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 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, você aprenderá a:
- Criar um produto
- Habilitar a implantação baseada em nuvem para seu dispositivo
- Criar a implantação
- Implantação de gatilho
- Reativar o desenvolvimento e a depuração
Pré-requisitos
- Seu dispositivo do Azure Sphere está conectado ao seu computador e à Internet.
- Você concluiu o Tutorial: Criar um aplicativo de alto nível e ter 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 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 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 as atualizações de aplicativo baseado em nuvem. Use o comando azsphere device enable-cloud-test para preparar seu dispositivo:
azsphere device enable-cloud-test --product MyProduct
Esse 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 aplicativos baseadas 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 deseja atualizar o aplicativo 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 em um determinado grupo de dispositivos.
Para criar uma implantação:
- Carregue o pacote de imagem em 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 grupo de dispositivos Field Test, 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. 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 par de nome do produto e nome do grupo de dispositivos no <formato product-name>/<device-group-name> . Esse par de nomes identifica exclusivamente um grupo de dispositivos para um produto específico.
Especifique o grupo de dispositivos Teste de campo e o nome do produto que você criou em Criar um produto.
Substitua <image-ID> pela ID da imagem do pacote de imagens que você criou no 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.
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 Reiniciar no dispositivo do Azure Sphere. O aplicativo deve ser baixado e iniciado em alguns minutos; o LED 1 deve começar a piscar.
Para verificar se o aplicativo foi instalado em seu dispositivo, use o comando azsphere device image list-installed. 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
Enquanto você continua desenvolvendo e testando aplicativos, provavelmente desejará realizar o sideload deles até estar pronto para implantá-los de maneira 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.
Prossiga 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
Solucionar problemas
Se você encontrar problemas com as operações acima, consulte as diretrizes de solução de problemas.