Criar uma implantação
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).
Para implantar seus aplicativos da nuvem, carregue as imagens do aplicativo para seu locatário do Azure Sphere e crie uma implantação para distribuir as 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.
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 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:
azsphere product create --name <product-name>
Substitua <o nome> do produto por um nome para o seu produto, como DW100. Consulte azsphere product para obter mais informações sobre este comando.
As implantações destinam-se a grupos de dispositivos, portanto, você também precisará atribuir seus dispositivos a um grupo de dispositivos que permita atualizações na 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 na nuvem, use azsphere device-group show.
Os dispositivos também devem estar preparados para o carregamento na nuvem, o que significa que eles não têm a capacidade appDevelopment . Quando enviados de fábrica, os dispositivos não têm essa capacidade. No entanto, se você usou um dispositivo para desenvolvimento de aplicativos, provavelmente adicionou esse recurso com o comando azsphere device enable-development (chamado azsphere device prep-debug em versões anteriores de visualização do SDK).
Para remover o recurso, use azsphere device enable-cloud-test:
azsphere device enable-cloud-test --device-group <device-group-ID> or '<product-name>/<device-group-name>'
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. Para obter mais informações, consulte deployment create.
Criar uma implantação para um grupo de dispositivos
As implantações podem conter configurações de aplicativos e placas, 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 dentro de um grupo de dispositivos. 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.
Para criar uma implantação:
Carregue o pacote de imagens:
azsphere image add --image <path-to-image> --regional-data-boundary <value>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 '<product-name>/<device-group-name>' --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.
O --images parâmetro fornece o ID de imagem do arquivo de pacote de imagem para o aplicativo. A imagem é carregada para o seu inquilino 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 nenhum valor for especificado, o valor padrão será usado.
Por exemplo:
azsphere image add --image my-app.imagepackage --regional-data-boundary "None"
azsphere device-group deployment create --device-group "DW100/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 inferior a 1 MiB.
- A implantação não pode ter mais de um arquivo de configuração de placa.
Atualizar uma implantação
Para atualizar uma implantação, use os comandos azsphere image add e azsphere device-group deployment create novamente, conforme descrito na seção anterior, e especifique o caminho para o arquivo de aplicativo atualizado.