Partilhar via


Gerenciar manifestos de implantação do IoT Edge em seu aplicativo IoT Central

Um manifesto de implantação permite especificar os módulos que o tempo de execução do IoT Edge deve baixar e configurar. Um dispositivo IoT Edge pode baixar um manifesto de implantação quando se conecta pela primeira vez ao seu aplicativo IoT Central. Este 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, consulte Conectar dispositivos do Azure IoT Edge a um aplicativo do Azure IoT Central.

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

Gerenciar manifestos de implantação

A página Manifestos de borda permite gerenciar os manifestos de implantação em seu aplicativo. Nesta 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 de Borda, selecione + Novo.

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

  3. Se seu aplicativo usa 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.

    Screenshot that shows an uploaded and validated deployment manifest.

  5. Selecione Seguinte. A página Revisão e conclusão mostra informações sobre o manifesto de implantação e os módulos que ele define. Você também pode visualizar o JSON bruto.

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

Gorjeta

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

Editar a origem 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 de borda.

  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 Guardar.

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

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

  1. Navegue até a página Manifestos de borda.

  2. Selecione o manifesto de implantação que 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 Seguinte. A página Revisar e concluir mostra informações sobre o novo manifesto de implantação e os módulos que ele define. Você também pode visualizar o JSON bruto.

  5. Selecione Guardar. A página Manifestos de borda 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 dispositivo carregados anteriormente na página Manifestos de borda. Também é possível adicionar um manifesto de implantação diretamente a um dispositivo depois de criar o dispositivo.

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 novo dispositivo será semelhante à seguinte captura de tela:

Screenshot that shows adding an unassigned device to your application.

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

  1. Alternar o 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 atribuído a um modelo de dispositivo, a caixa de diálogo Criar um novo dispositivo será semelhante à seguinte captura de tela:

Screenshot that shows adding an assigned device to your application.

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

  1. A alternância do 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 você não selecionar um manifesto de implantação ao criar um dispositivo IoT Edge, poderá atribuir um posteriormente individualmente ou a vários dispositivos usando um trabalho.

Atualizar o manifesto de implantação que um dispositivo usa

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

Screenshot that shows the options to manage a deployment manifest on a device.

Use Atribuir manifesto de borda para selecionar um manifesto de implantação carregado anteriormente na página Manifestos de borda. Você também pode usar essa opção para notificar manualmente um dispositivo se modificar o manifesto de implantação na página Manifestos de Borda.

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

Tarefas

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 de borda:

Screenshot that shows the deployment manifest job type.

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 você estiver atribuindo um modelo de dispositivo a um dispositivo IoT Edge, convém definir os módulos e as propriedades graváveis no modelo de dispositivo. Para adicionar os módulos e as definições de propriedade a um modelo de dispositivo:

  1. Navegue até a página Resumo dos módulos do modelo de dispositivo IoT Edge.
  2. Selecione Importar 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:

Screenshot the shows importing module definitions to a device template.