Partilhar via

Criar uma implementação

  • Artigo

Para implementar as suas aplicações a partir da cloud, carregue as imagens da aplicação para o catálogo do Azure Sphere e crie uma implementação para distribuir as imagens por dispositivos do Azure Sphere. Para criar uma implementação, tem de ter sessão iniciada no Azure e ter as permissões RBAC adequadas concedidas. Além disso, os seus dispositivos têm de estar preparados para receber implementações na cloud.

Nota

Cada componente numa implementação tem de ter um GUID exclusivo. Se basear a sua aplicação num exemplo do Azure Sphere, lembre-se de criar um GUID exclusivo para a sua aplicação antes de criar uma implementação para evitar possíveis conflitos.

Preparar os dispositivos

Antes de os seus dispositivos poderem receber aplicações da cloud, têm de ter um produto e pertencer a um grupo de dispositivos e não podem ter a capacidade AppDevelopment instalada.

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:

az sphere product create --resource-group MyResourceGroup --catalog MyCatalog --name MyProduct --description MyDescription

Substitua <MyProduct> por um nome para o seu produto, como DW100. Veja az sphere product (produto az sphere ) para obter mais informações sobre este comando.

As implementações visam grupos de dispositivos, pelo que também terá de atribuir os seus dispositivos a um grupo de dispositivos que permita atualizações na cloud antes de poderem receber as aplicações implementadas. Por predefinição, cada produto tem cinco grupos de dispositivos: Produção, Teste de Campo, Desenvolvimento, Avaliação do SO de Teste de Campo e Avaliação do SO de Produção. Pode utilizar um destes grupos de dispositivos ou criar os seus próprios grupos. Para saber se um grupo de dispositivos aceita atualizações da cloud, utilize az sphere device-group show.

Os dispositivos também têm de estar preparados para o carregamento na cloud, o que significa que não têm a capacidade appDevelopment . Quando enviados a partir da fábrica, os dispositivos não têm esta capacidade. No entanto, se utilizou um dispositivo para o desenvolvimento de aplicações, provavelmente adicionou esta capacidade com o comando az sphere device enable-development .

Para remover a capacidade, utilize az sphere device enable-cloud-test:

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

Para obter mais informações, veja Criação da implementação.

Criar uma implementação para um grupo de dispositivos

As implementações podem conter configurações de aplicações e quadros e ambas são processadas da mesma forma quando cria uma implementação. As implementações são conjuntos de imagens a serem distribuídas para todos os dispositivos dentro de um grupo de dispositivos. Cada implementação está ligada a um grupo de dispositivos específico dentro de um produto específico. Tem de incluir o nome do produto e o nome do grupo de dispositivos (como mostra o exemplo seguinte) ou o ID do grupo de dispositivos quando criar a implementação.

Para criar uma implementação:

  1. Carregue o pacote de imagem:

    az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path <path-to-image> --regional-data-boundary <value>

  2. Criar uma nova implementação para um grupo de dispositivos:

    az sphere deployment create --resource-group MyResourceGroup --catalog MyCatalog --product <product-name> --device-group <device-group-ID> --images <image-ID>

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

O --images parâmetro fornece o ID de imagem do ficheiro de pacote de imagem para a aplicação. A imagem é carregada para o catálogo atual.

O --regional-data-boundary parâmetro especifica o limite de dados regionais para esta imagem. Os valores permitidos são EU e None. O valor predefinido é None. Se não for especificado nenhum valor, será utilizado o valor predefinido.

Por exemplo (alguns parâmetros removidos por questões de brevidade):

az sphere image add --image my-app.imagepackage --regional-data-boundary "None"

az sphere deployment create --product "DW100" --device-group "Field Test" --images e3769536-dc4b-48d9-afd4-22ed321ba4bc

Regras para uma implementação válida

Para ser válido, uma implementação tem de seguir estas regras:

  • O tamanho total da implementação tem de ser inferior a 1 MiB.
  • A implementação não pode ter mais do que um ficheiro de configuração de quadro.

Atualizar uma implementação

Para atualizar uma implementação, utilize os comandos az sphere image add e az sphere deployment create , conforme descrito na secção anterior, e especifique o caminho para o ficheiro de aplicação atualizado.