Implantar módulos do Azure IoT Edge do portal do Azure

Aplica-se a: IoT Edge 1.5

Após criar os módulos do IoT Edge com a lógica de negócios, você pretende implantá-los nos dispositivos para operar na borda. Se houver vários módulos trabalhando em conjunto para coletar e processar dados, será possível implantá-los todos de uma vez e declarar as regras de roteamento que conecta-os.

Este artigo mostra como o portal do Azure guia você por meio da criação de um manifesto de implantação e de empurrar a implantação a um dispositivo IoT Edge. Para obter informações sobre como criar uma implantação direcionada a vários dispositivos com base em suas marcas compartilhadas, consulte Implantar módulos do IoT Edge em escala usando o portal do Azure.

Pré-requisitos

• Um Hub IoT na assinatura do Azure.

• Um dispositivo do IoT Edge.

  Se você não tiver um dispositivo IoT Edge configurado, poderá criar um em uma máquina virtual do Azure. Siga as etapas em um dos artigos de início rápido para criar um dispositivo Linux virtual ou criar um dispositivo Virtual do Windows.

Configurar um manifesto de implantação

Um manifesto de implantação é um documento JSON que descreve quais módulos implantar, como os dados fluem entre os módulos e as propriedades desejadas dos módulos gêmeos. Para obter mais informações sobre como os manifestos de implantação funcionam e como criá-los, consulte Saiba como implantar módulos e estabelecer rotas no IoT Edge.

O portal do Azure tem um assistente que ajuda você por meio da criação de manifesto de implantação, em vez de compilar manualmente o documento JSON. Ele tem três etapas: Adicionar módulos, Especificar rotas, e Rever implantação.

Selecionar dispositivo e adicionar módulos

1. Entre no portal do Azure e navegue até o hub IoT.

2. No painel à esquerda, selecione Dispositivos no menu Gerenciamento de dispositivos.

3. Selecione o dispositivo IoT Edge de destino na lista.

4. Na barra superior, selecione Definir Módulos.

5. Na seção Credenciais do Registro de Contêiner da página, forneça credenciais para acessar registros de contêiner que contêm imagens de módulo. Por exemplo, seus módulos estão no registro de contêiner privado ou você está usando um registro de contêiner de parceiro que requer autenticação.

6. Na seção Módulos do IoT Edge da página, selecione Adicionar.

   

7. Escolha o tipo de módulo que você deseja adicionar no menu suspenso. Você pode adicionar módulos do IoT Edge ou módulos do Azure Stream Analytics.

Módulo do IoT Edge

Use esta opção para adicionar módulos da Microsoft, módulos de parceiros ou módulos personalizados. Você fornece o nome do módulo e o URI da imagem do contêiner. O URI da imagem do contêiner é o local da imagem do módulo em um registro de contêiner. Para obter uma lista de imagens do módulo do Microsoft IoT Edge, confira o Registro de Artefato da Microsoft. Para módulos de parceiro, entre em contato com o editor de módulos do IoT Edge para obter o URI da imagem do contêiner.

Por exemplo, para adicionar o módulo do sensor de temperatura simulado da Microsoft:

1. Digite as seguintes configurações:

   Configuração	Valor
   URI da imagem	mcr.microsoft.com/azureiotedge-simulated-temperature-sensor
   Política de reinicialização	sempre
   Status Desejado	executando

   

2. Selecione Adicionar.

3. Depois de adicionar um módulo, selecione o nome do módulo na lista para abrir as configurações do módulo. Preencha os campos opcionais se necessário.

   

Para obter mais informações sobre as configurações de módulo disponíveis, confira Configuração e gerenciamento de módulo.

Para obter mais informações sobre o módulo gêmeo, consulte Definir ou atualizar as propriedades desejadas.

Módulo do Azure Stream Analytics

Use esta opção para módulos gerados a partir de uma carga de trabalho do Azure Stream Analytics.

1. Selecione sua assinatura e o trabalho de Edge do Azure Stream Analytics que você criou.
2. Selecione Salvar.

Para obter mais informações sobre como implantar o Azure Stream Analytics em um módulo do IoT Edge, confira Tutorial: implantar o Azure Stream Analytics como um módulo do IoT Edge.

Especificar Rotas

Na guia Rotas , você define como as mensagens são passadas entre módulos e o hub IoT. As mensagens são construídas usando pares nome/valor. Por padrão, a primeira implantação de um novo dispositivo inclui uma rota chamada rota e definida como FROM /messages/* INTO $upstream, o que significa que qualquer saída de mensagens por qualquer módulo é enviada para o hub IoT.

Os parâmetros Priority e Time to live são opcionais, e você pode incluí-los em uma definição de rota. O parâmetro priority permite que você escolha quais rotas devem ter suas mensagens processadas primeiro ou por último. A prioridade é determinada pela configuração de um número 0-9, em que 0 é a prioridade mais alta. O parâmetro time to live permite que você declare por quanto tempo as mensagens nessa rota devem ser mantidas até que sejam processadas ou removidas da fila.

Para obter mais informações sobre como criar rotas, confira Declarar rotas.

Depois que as rotas forem definidas, selecione Avançar: revisar + criar para continuar na próxima etapa do assistente.

Rever implantação

A seção de revisão mostra o manifesto de implantação JSON que foi criado baseado nas suas seleções nas duas seções anteriores. Há dois módulos declarados que você não adicionou: $edgeAgent e $edgeHub. Estes dois módulos enganam o runtime do IoT Edge e são padrões requeridos em toda implantação.

Examine as informações da sua implantação e selecione Criar.

Exibir módulos no dispositivo

Depois de implantar módulos em seu dispositivo, você pode exibir todos eles na página de detalhes do dispositivo do hub IoT. Esta página exibe o nome de cada módulo implantado e informações úteis, como o status da implantação e o código de saída.

Selecione Avançar: Roteia e continue com a implantação conforme descrito por Especificar rotas e Examinar a implantação anteriormente neste artigo.

Próximas etapas

Saiba como implantar módulos do IoT Edge em escala usando o portal do Azure.