Implantar módulos do Azure IoT Edge do Visual Studio Code
Aplica-se a: IoT Edge 1.5 IoT Edge 1.4
Importante
O IoT Edge 1.5 LTS e o IoT Edge 1.4 LTS são versões com suporte. O fim da vida útil do IoT Edge 1.4 LTS é 12 de novembro de 2024. Se você estiver em uma versão anterior, confira Atualizar o IoT Edge.
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 criar um manifesto de implantação JSON e usar esse arquivo para enviar a implantação a um dispositivo do IoT Edge. Para obter informações sobre como criar uma implantação voltada para vários dispositivos com base nas marcações compartilhadas, confira Implantar módulos do IoT Edge em escala usando o Visual Studio Code.
Pré-requisitos
Um Hub IoT na assinatura do Azure.
Um dispositivo 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 virtual do Linux ou Criar um dispositivo virtual do Windows.
Azure IoT Edge para Visual Studio Code. A extensão das Ferramentas de Azure IoT Edge para Visual Studio Code está em modo de manutenção.
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 Entender como os módulos do IoT Edge podem ser utilizados, configurados e reutilizados.
Para implantar módulos usando o Visual Studio Code, salve o manifesto de implantação localmente como um arquivo .JSON. Você usará o caminho do arquivo na próxima seção quando executar o comando para aplicar a configuração ao dispositivo.
A seguir, é apresentado um manifesto básico de implantação com um módulo como um exemplo:
Observação
Este exemplo de manifesto de implantação usa a versão 1.1 do esquema para o hub e o agente IoT Edge. A versão 1.1 do esquema foi lançada junto com o IoT Edge versão 1.0.10 e habilita recursos como a priorização de rota e a ordem de inicialização do módulo.
{
"modulesContent": {
"$edgeAgent": {
"properties.desired": {
"schemaVersion": "1.1",
"runtime": {
"type": "docker",
"settings": {
"minDockerVersion": "v1.25",
"loggingOptions": "",
"registryCredentials": {}
}
},
"systemModules": {
"edgeAgent": {
"type": "docker",
"settings": {
"image": "mcr.microsoft.com/azureiotedge-agent:1.5",
"createOptions": "{}"
}
},
"edgeHub": {
"type": "docker",
"status": "running",
"restartPolicy": "always",
"settings": {
"image": "mcr.microsoft.com/azureiotedge-hub:1.5",
"createOptions": "{\"HostConfig\":{\"PortBindings\":{\"443/tcp\":[{\"HostPort\":\"443\"}],\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}]}}}"
}
}
},
"modules": {
"SimulatedTemperatureSensor": {
"version": "1.5",
"type": "docker",
"status": "running",
"restartPolicy": "always",
"settings": {
"image": "mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.5",
"createOptions": "{}"
}
}
}
}
},
"$edgeHub": {
"properties.desired": {
"schemaVersion": "1.1",
"routes": {
"route": "FROM /messages/* INTO $upstream"
},
"storeAndForwardConfiguration": {
"timeToLiveSecs": 7200
}
}
},
"SimulatedTemperatureSensor": {
"properties.desired": {}
}
}
}
Entre para acessar o Hub IoT
É possível usar as extensões do Azure IoT para Visual Studio Code para executar operações com o Hub IoT. Para que essas operações funcionem, é necessário entrar na conta do Azure e selecionar o hub IoT em que está trabalhando.
No Visual Studio Code, abra a exibição do Explorer.
Na parte inferior do Explorer, expanda a seção Hub IoT.
Clique em ... no cabeçalho da seção Hub IoT. Se você não visualizar as reticências, passe o mouse sobre o cabeçalho.
Escolha Selecionar Hub IoT.
Se não estiver conectado à conta do Azure, siga as instruções para fazer isso.
Selecione sua assinatura do Azure.
Selecione seu Hub IoT.
Implantar no seu dispositivo
Você implanta módulos no dispositivo, aplicando o manifesto de implantação configurado com as informações do módulo.
Na exibição do explorador do Visual Studio Code, expanda a seção Hub IoT do Azure e, em seguida, expanda o nó Dispositivos.
Clique com o botão direito do mouse no dispositivo IoT Edge que você quer configurar com o manifesto de implantação.
Dica
Para confirmar que o dispositivo que você escolheu é um dispositivo IoT Edge, selecione-o para expandir a lista de módulos e verificar a presença de $edgeHub e $edgeAgent. Todos os dispositivos IoT Edge incluem esses dois módulos.
Selecione Criar implantação para dispositivo único.
Navegue até o arquivo JSON do manifesto de implantação que você quer usar e clique em Selecionar manifesto de implantação do Edge.
Os resultados da implantação são impressos na saída do Visual Studio Code. Implantações com êxito são aplicadas em poucos minutos se o dispositivo de destino estiver em execução e conectado à Internet.
Exibir módulos no dispositivo
Após implantar os módulos no dispositivo, você verá todos eles na seção Hub IoT do Azure. Selecione a seta ao lado do dispositivo do IoT Edge para expandi-lo. Todos os módulos atualmente em execução serão exibidos.
Se você implantou recentemente novos módulos em um dispositivo, passe o mouse sobre o cabeçalho da seção Dispositivos do Hub IoT e selecione o ícone de atualização para atualizar a exibição.
Clique com o botão direito do mouse no nome de um módulo para exibir e editar o módulo gêmeo.
Próximas etapas
Saiba como Implantar e monitorar módulos do IoT Edge em escala usando o Visual Studio Code