Criar uma implantação

  • Artigo

Para implantar seus aplicativos na nuvem, carregue as imagens do aplicativo no catálogo do Azure Sphere e crie uma implantação para distribuir as imagens para dispositivos do Azure Sphere. Para criar uma implantação, você deve entrar no Azure e deve ter as permissões RBAC apropriadas concedidas. Além disso, seus dispositivos devem estar preparados para receber implantações na nuvem.

Nota

Cada componente em uma implantação deve ter um GUID exclusivo. Se você basear seu aplicativo em um exemplo do Azure Sphere, lembre-se de criar um GUID exclusivo para seu aplicativo antes de criar uma implantação para evitar possíveis conflitos.

Preparar os dispositivos

Antes que seus dispositivos possam receber aplicativos da nuvem, eles devem ter um produto e pertencer a um grupo de dispositivos e não poderão ter a funcionalidade AppDevelopment instalada.

Se você ainda não criou um produto para seus dispositivos, precisará fazê-lo antes de criar uma implantação. Para criar um produto:

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

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

As implantações visam grupos de dispositivos, portanto, você também precisará atribuir seus dispositivos a um grupo de dispositivos que habilita atualizações de nuvem antes que eles possam receber seus 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 descobrir se um grupo de dispositivos aceita atualizações de nuvem, use az sphere device-group show.

Os dispositivos também devem estar preparados para carregamento em nuvem, o que significa que eles não têm a funcionalidade appDevelopment . Quando enviados da fábrica, os dispositivos não têm essa funcionalidade. No entanto, se você usou um dispositivo para desenvolvimento de aplicativos, provavelmente adicionou essa funcionalidade com o comando az sphere device enable-development .

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

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

Para obter mais informações, confira criação de implantação.

Criar uma implantação para um grupo de dispositivos

As implantações podem conter aplicativos e configurações de placa e ambas são tratadas da mesma maneira quando você cria uma implantação. As implantações são conjuntos de imagens a serem distribuídas para todos os dispositivos em um grupo de dispositivos. Cada implantação está vinculada a um grupo de dispositivos específico em um produto específico. Você deve incluir o nome do produto e o nome do grupo de dispositivos (como o exemplo a seguir mostra) ou a ID do grupo de dispositivos ao criar a implantação.

Para criar uma implantação:

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

O --images parâmetro fornece a ID de imagem do arquivo de pacote de imagem para o aplicativo. A imagem é carregada no catálogo atual.

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

Por exemplo (alguns parâmetros removidos para 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 implantação válida

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

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

Atualizar uma implantação

Para atualizar uma implantação, use o az sphere image add e az sphere deployment create commands again, conforme descrito na seção anterior, e especifique o caminho para o arquivo de aplicativo atualizado.