Implantar módulos do Azure IoT Edge a partir do Visual Studio Code
Aplica-se a:
IoT Edge 1.5 IoT Edge 1.4
Importante
IoT Edge 1.5 LTS e IoT Edge 1.4 LTS são versões suportadas. O IoT Edge 1.4 LTS termina a vida útil em 12 de novembro de 2024. Se tiver uma versão anterior, consulte Atualizar IoT Edge.
Depois de criar módulos do IoT Edge com sua lógica de negócios, você deseja implantá-los em seus dispositivos para operar na borda. Se você tiver vários módulos que trabalham juntos para coletar e processar dados, poderá implantá-los todos de uma vez e declarar as regras de roteamento que os conectam.
Este artigo mostra como criar um manifesto de implantação JSON e, em seguida, usar esse arquivo para enviar a implantação por push para um dispositivo IoT Edge. Para obter informações sobre como criar uma implantação destinada a vários dispositivos com base em suas tags compartilhadas, consulte Implantar módulos do IoT Edge em escala usando o Visual Studio Code.
Pré-requisitos
Um hub IoT em sua 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 Linux virtual ou Criar um dispositivo virtual do Windows.
Azure IoT Edge para Visual Studio Code. A extensão de código das ferramentas do Azure IoT Edge para Visual Studio está no 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 gêmeos de módulo. Para obter mais informações sobre como os manifestos de implantação funcionam e como criá-los, consulte Compreender como os módulos do IoT Edge podem ser usados, configurados e reutilizados.
Para implantar módulos usando o Visual Studio Code, salve o manifesto de implantação localmente como um arquivo . Arquivo JSON. Você usará o caminho do arquivo na próxima seção quando executar o comando para aplicar a configuração ao seu dispositivo.
Aqui está um manifesto de implantação básica com um módulo como exemplo:
Nota
Este exemplo de manifesto de implantação usa o esquema versão 1.1 para o agente e o hub do IoT Edge. O esquema versão 1.1 foi lançado junto com o IoT Edge versão 1.0.10 e permite recursos como ordem de inicialização do módulo e priorização de rota.
{
"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": {}
}
}
}
Inicie sessão para aceder ao seu hub IoT
Você pode usar as extensões do Azure IoT para Visual Studio Code para executar operações com seu hub IoT. Para que essas operações funcionem, você precisa entrar em sua conta do Azure e selecionar o hub IoT no qual está trabalhando.
No Visual Studio Code, abra o modo de exibição Explorer .
Na parte inferior do Explorer, expanda a seção Hub IoT do Azure.
Clique no cabeçalho da seção ... no cabeçalho da seção Hub IoT do Azure. Se não vir as reticências, passe o cursor sobre o cabeçalho.
Escolha Selecionar Hub IoT.
Se você não estiver conectado à sua conta do Azure, siga as instruções para fazer isso.
Selecione a subscrição do Azure.
Selecione seu hub IoT.
Implementar no seu novo dispositivo
Você implanta módulos em seu dispositivo aplicando o manifesto de implantação que você configurou com as informações do módulo.
Na vista do explorador de códigos do Visual Studio, expanda a secçã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ê deseja configurar com o manifesto de implantação.
Gorjeta
Para confirmar se o dispositivo escolhido é 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 um único dispositivo.
Navegue até o arquivo JSON do manifesto de implantação que você deseja usar e clique em Selecionar Manifesto de Implantação de Borda.
Os resultados de sua implantação são impressos na saída do Visual Studio Code. As implantações bem-sucedidas são aplicadas em poucos minutos se o dispositivo de destino estiver em execução e conectado à Internet.
Ver módulos no seu dispositivo
Depois de implantar módulos em seu dispositivo, você pode exibir todos eles na seção Hub IoT do Azure. Selecione a seta ao lado do dispositivo IoT Edge para expandi-lo. Todos os módulos atualmente em execução sã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 do Azure e selecione o ícone de atualização para atualizar a exibição.
Clique com o botão direito do rato no nome de um módulo para ver e editar o módulo gémeo.
Próximos passos
Saiba como implantar e monitorar módulos do IoT Edge em escala usando o Visual Studio Code