Criar uma implantação na nuvem

Para implantar seus aplicativos da nuvem, carregue imagens de aplicativos em um catálogo do Azure Sphere e crie uma implantação para distribuir imagens para dispositivos do Azure Sphere. Para criar uma implantação, você deve estar conectado ao Azure Sphere e deve ter a função de Administrador. Além disso, seus dispositivos devem estar preparados para receber implantações na nuvem.

Para ser válida, uma implantação deve seguir estas regras:

• O tamanho total da implantação deve ser inferior a 1 MiB.
• A implantação não pode ter mais de um arquivo de configuração de placa.

Preparar dispositivos

Antes que os dispositivos possam receber aplicativos da nuvem, eles devem ter um produto e pertencer a um grupo de dispositivos, e não podem ter o recurso AppDevelopment instalado.

Se ainda não criou um produto para os seus dispositivos, tem de o fazer antes de poder criar uma implementação. Para criar um produto:

Utilizar o portal

1. Inicie sessão no Portal do Azure. Para localizar o serviço Azure Sphere, na barra de pesquisa superior, insira e selecione Azure Sphere. A página Azure Sphere é exibida.
2. Selecione o catálogo no qual você deseja criar uma implantação. Verifique se o filtro de assinatura está definido adequadamente para ver todos os catálogos e grupos de recursos.
3. Selecione Gerenciar >produtos no lado esquerdo da página do catálogo.
4. Clique em + Criar na parte superior da página do catálogo.
5. Insira um nome e uma descrição para o produto. Marque a caixa de seleção para indicar se grupos de dispositivos padrão devem ser criados. Se marcados, os seguintes grupos de dispositivos padrão serão criados: Desenvolvimento, Teste de campo, Avaliação do sistema operacional de teste de campo, Produção, Avaliação do sistema operacional de produção.
6. Por fim, clique em Criar na parte inferior da página.

Se você optar por não criar um grupo de dispositivos padrão, um grupo de dispositivos deverá ser criado manualmente e associado ao produto:

1. Selecione Gerenciar>grupos de dispositivos no lado esquerdo da página.
2. Clique em + Criar na parte superior da página.
3. Selecione o produto criado a partir das etapas acima.
4. Insira um nome para o grupo de dispositivos e uma breve descrição.
5. Selecione o feed do sistema operacional (SO) para o grupo de dispositivos. O feed RetailEval recebe versões de pré-lançamento do sistema operacional antes do feed de varejo . O RetailEval não é, portanto, recomendado para dispositivos de produção. Selecione o feed de varejo para dispositivos de produção.
6. Selecione a política de atualização para o grupo de dispositivos. UpdateAll significa que os dispositivos do grupo receberão atualizações do sistema operacional e do aplicativo quando disponíveis. No3rdPartyAppUpdates significa que os dispositivos do grupo só receberão atualizações do sistema operacional.

Utilizar a CLI

Gorjeta

Recomendamos que você configure os valores padrão para os parâmetros de assinatura, grupo de recursos e catálogo. Isso ajuda a reduzir a redundância e pode encurtar significativamente a sintaxe de comando da CLI.

A menos que você tenha definido a assinatura ativa, o --subscription parâmetro será necessário para todos os comandos. Você pode definir a assinatura ativa usando o comando az account set --subscription <subscription-name>.

Utilize o comando az sphere product create.

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

Use o az sphere device-group create comando para criar um grupo de dispositivos e associá-lo ao produto.

az sphere device-group create --resource-group MyResourceGroup --catalog MyCatalog   --name "My Development Device Group" --product MyProduct -d "development device group for MyProduct"

As implantações destinam-se a grupos de dispositivos. Os dispositivos precisarão ser atribuídos a um grupo de dispositivos que tenha atualizações na nuvem habilitadas para que os dispositivos possam receber aplicativos implantados. Por padrão, cada produto tem cinco grupos de dispositivos: Produção, Teste de campo, Desenvolvimento, Avaliação do sistema operacional de teste de campo e Avaliação do sistema operacional de produção. Você pode usar um desses grupos de dispositivos ou criar o seu próprio. Para saber se um grupo de dispositivos aceita atualizações na nuvem, use az sphere device-group show.

Os dispositivos dentro do grupo de dispositivos devem estar preparados para carregamento na nuvem. Isso significa que eles não devem ter a capacidade appDevelopment . Os dispositivos enviados diretamente da fábrica normalmente não têm o recurso appDevelopment . A capacidade é adicionada quando az sphere device enable-development command é usado.

Para remover o recurso appDevelopment, use az sphere device enable-cloud-test:

Utilizar a CLI

Utilize o comando az sphere device enable-cloud-test.

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

Criar uma implantação para um grupo de dispositivos

As implantações são conjuntos de imagens a serem distribuídas para todos os dispositivos dentro de um grupo de dispositivos. Uma implantação pode conter aplicativos e configurações de placa. Cada implantação está vinculada a um grupo de dispositivos específico dentro de um produto específico. Você deve incluir o nome do produto e o nome do grupo de dispositivos (como mostra o exemplo a seguir) ou a ID do grupo de dispositivos ao criar a implantação.

Utilizar o portal

1. Inicie sessão no Portal do Azure. Para localizar o serviço Azure Sphere, na barra de pesquisa superior, insira e selecione Azure Sphere. A página Azure Sphere é exibida.
2. Selecione o catálogo no qual você deseja criar uma implantação. Verifique se o filtro de assinatura está definido adequadamente para ver todos os catálogos e grupos de recursos.
3. Selecione Gerenciar>produtos no lado esquerdo da página.
4. A próxima página mostra uma tabela com todos os produtos criados listados. Selecione o produto para o qual você deseja criar uma implantação.
5. Uma tabela mostra todos os grupos de dispositivos associados ao produto escolhido. Selecione o grupo de dispositivos para o qual você deseja criar uma implantação.
6. Selecione a guia Implantações .
7. Clique em +Criar abaixo da guia implantações.
8. Na vista apresentada, selecione a imagem existente ou clique em +Adicionar para carregar uma nova imagem.
9. Na parte inferior da vista, clique em +Criar.

Utilizar a CLI

Conclua as etapas em Preparar dispositivos antes de prosseguir e, em seguida:

1. Carregue um pacote de imagens, anotando o imageId retornado pelo comando:

   az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path myImage.imagepackage
   

2. Use o azsphere image-package show comando para obter o imageId do pacote de imagens:

   azsphere image-package show --image-package myImage.imagepackage
   

   Nota

   image-package show atualmente não tem suporte na extensão CLI do Azure.

   O comando retorna informações sobre o pacote de imagens, incluindo o imageId:

   Image package metadata:
     Section: Identity
      Image Type: Application
      Component ID: 1689d8b2-c835-2e27-27ad-e894d6d15fa9
      Image ID: be3f90bd-849f-487e-a170-7fe1ff03fe2d
     Section: Signature
      Signing Type: ECDsa256
      Cert: a8d5cc6958f48710140d7a26160fc1cfc31f5dfO
     Section: Debug 
      Image Name:       myImage
      Built On (UTC):   02/21/22 16:21:58
      Built On (Local): 02/21/22 16:21:58
     Section: Temporary Image
   

3. Crie uma nova implantação para um grupo de dispositivos:

   az sphere deployment create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --images <imageId returned from previous step>
   

Várias imagens podem ser fornecidas para o --images parâmetro usando uma lista separada por espaço de IDs de imagem.

Para listar grupos de dispositivos em um catálogo, use az sphere device-group list.

Para listar todas as imagens em um catálogo, use az sphere image list.

Atualizar uma implantação

Não é possível atualizar uma implantação. Em vez disso, uma nova implantação deve ser criada. Repita as etapas da seção anterior, atualizando os parâmetros quando necessário.