Gerenciar um manifesto de implantação do IoT Edge no aplicativo do IoT Central

Um manifesto de implantação permite especificar os módulos que o runtime do IoT Edge deve baixar e configurar. Um dispositivo IoT Edge pode baixar um manifesto de implantação ao se conectar pela primeira vez ao aplicativo do IoT Central. Esse artigo descreve como você gerencia manifestos de implantação em seu aplicativo IoT Central.

Para saber mais sobre o IoT Edge e o IoT Central, confira Conectar dispositivos Azure IoT Edge a um aplicativo Azure IoT Central.

Para saber como gerenciar manifestos de implantação usando a API REST do IoT Central, veja Como usar a API REST do IoT Central para gerenciar manifestos de implantação.

Gerenciar manifestos de implantação

A página Manifestos do Edge permite que você gerencie os manifestos de implantação em seu aplicativo. Nessa página você pode:

• Carregar ou criar manifestos de implantação
• Modificar manifestos de implantação existentes
• Excluir manifestos de implantação

Carregar e criar manifestos de implantação

Ao criar um novo manifesto de implantação, você pode carregar o arquivo JSON do manifesto de implantação ou começar com um manifesto existente:

1. Na página Manifestos do Edge, selecione + Novo.

2. Insira um nome para o manifesto de implantação.

3. Se o aplicativo usar organizações, selecione uma organização à qual associar o manifesto de implantação.

4. Procure um arquivo de manifesto de implantação para carregar ou escolha um manifesto de implantação existente como ponto de partida para o novo. O IoT Central valida todos os arquivos carregados.

   

5. Selecione Avançar. A página Examinar e concluir mostra informações sobre o manifesto de implantação e os módulos que ele define. Você também pode exibir o JSON bruto.

6. Selecione Criar. A página Manifestos do Edge agora inclui o novo manifesto de implantação.

Dica

Se você tiver um grande número de manifestos de implantação, poderá classificar e filtrar a lista mostrada na página Manifestos do Edge.

Editar a origem do JSON de um manifesto de implantação

Para modificar um manifesto de implantação editando o JSON diretamente:

1. Navegue até a página Manifestos do Edge.

2. Selecione Editar JSON no menu de contexto do manifesto de implantação que você deseja modificar.

3. Use o editor JSON para fazer as alterações necessárias. Em seguida, selecione Salvar.

Substituir o conteúdo de um manifesto de implantação

Para substituir totalmente o conteúdo de um manifesto de implantação:

1. Navegue até a página Manifestos do Edge.

2. Selecione o manifesto de implantação que você deseja substituir.

3. Na caixa de diálogo Personalizar, procure um novo arquivo de manifesto de implantação para carregar ou escolha um manifesto de implantação existente como ponto de partida. O IoT Central valida todos os arquivos carregados.

4. Selecione Avançar. A página Examinar e concluir mostra informações sobre o novo manifesto de implantação e os módulos que ele define. Você também pode exibir o JSON bruto.

5. Selecione Salvar. A página Manifestos do Edge agora inclui o manifesto de implantação atualizado.

Gerenciar dispositivos IoT Edge

Ao adicionar um dispositivo IoT Edge na página de dispositivos, você pode escolher um manifesto de implantação para o dispositivo. Na caixa de diálogo Criar um novo dispositivo, você pode escolher na lista de manifestos de dispositivos carregados anteriormente na página Manifestos do Edge. Também é possível adicionar um manifesto de implantação diretamente a um dispositivo depois de criá-lo.

Se você adicionar um dispositivo IoT Edge que não esteja atribuído a um modelo de dispositivo, a caixa de diálogo Criar um dispositivo será semelhante à seguinte captura de tela:

Para escolher o manifesto de implantação para o dispositivo:

1. Altere Dispositivo Azure IoT Edge? para Sim.

2. Selecione o manifesto de implantação do IoT Edge a ser usado. Você também pode optar por atribuir um manifesto de implantação depois de criar o dispositivo.

3. Selecione Criar.

Se você adicionar um dispositivo IoT Edge que esteja atribuído a um modelo de dispositivo, a caixa de diálogo Criar um dispositivo será semelhante à seguinte captura de tela:

Para escolher o manifesto de implantação para o dispositivo:

1. A alternância Dispositivo Azure IoT Edge? já está definida como Sim porque o IoT Central reconhece que você está usando um modelo de dispositivo IoT Edge.

2. Selecione o manifesto de implantação do IoT Edge a ser usado. Você também pode optar por atribuir um manifesto de implantação depois de criar o dispositivo.

3. Selecione Criar.

Quando um dispositivo IoT Edge se conecta ao seu aplicativo pela primeira vez, ele baixa o manifesto de implantação, configura os módulos especificados no manifesto de implantação e executa os módulos.

Se não selecionar um manifesto de implantação ao criar um dispositivo IoT Edge, você poderá atribuir um mais tarde individualmente ou a vários dispositivos usando um trabalho.

Atualizar o manifesto de implantação usado por um dispositivo

Você pode gerenciar o manifesto de implantação de um dispositivo existente:

Use Atribuir manifesto ao Edge para selecionar um manifesto de implantação carregado anteriormente na página Manifestos do Edge. Você também pode usar esta opção para notificar manualmente um dispositivo se você modificar o manifesto de implantação na página Manifestos do Edge*..

Use Editar manifesto para modificar o manifesto de implantação desse dispositivo. As alterações feitas aqui não afetam o manifesto de implantação na página Manifestos do Edge.

Trabalhos

Para atribuir ou atualizar o manifesto de implantação para vários dispositivos, use um trabalho. Use o tipo de trabalho Alterar manifesto de implantação do Edge:

Adicionar módulos e propriedades a modelos de dispositivo

Um manifesto de implantação define os módulos a serem executados no dispositivo e, opcionalmente, as propriedades graváveis que você pode usar para configurar módulos.

Se estiver atribuindo um modelo de dispositivo a um dispositivo IoT Edge, talvez você queira definir os módulos e as propriedades graváveis no modelo do dispositivo. Para adicionar os módulos e definições de propriedade a um modelo de dispositivo:

1. Navegue até a página Resumo de módulos do modelo de dispositivo IoT Edge.
2. Selecione Importar os módulos do manifesto.
3. Selecione o manifesto de implantação apropriado na lista.
4. Selecione Importar. O IoT Central adiciona os módulos personalizados definidos no manifesto de implantação ao modelo de dispositivo. Os nomes dos módulos no modelo de dispositivo correspondem aos nomes dos módulos personalizados no manifesto de implantação. A interface gerada inclui definições de propriedade para as propriedades definidas para o módulo personalizado no manifesto de implantação: