Depurar módulos do Azure IoT Edge por meio do Visual Studio Code

Artigo
04/11/2024

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 IoT Edge 1.4 LTS chegará ao fim da vida útil em 12 de novembro de 2024. Se você estiver em uma versão anterior, confira Atualizar o IoT Edge.

Este artigo mostra como usar o Visual Studio Code para depurar módulos do IoT Edge em várias linguagens. No computador de desenvolvimento, você pode usar o Visual Studio Code para anexar e depurar o módulo em um contêiner de módulo local ou remoto.

Este artigo inclui etapas para duas ferramentas de desenvolvimento IoT Edge.

CLI (ferramenta de linha de comando) da Ferramenta de Desenvolvimento do Azure IoT Edge. Essa ferramenta é preferencial para desenvolvimento.
Extensão do Azure IoT Edge Tools para Visual Studio Code. A extensão está no modo de manutenção.

Use o botão seletor de ferramentas no início deste artigo para selecionar a versão da ferramenta.

O Visual Studio Code dá suporte à gravação de módulos do IoT Edge nas seguintes linguagens de programação:

Azure Functions C# e C#
C
Python
Node.js
Java

O Azure IoT Edge dá suporte às seguintes arquiteturas de dispositivo:

AMD64
ARM32v7
ARM64

Para obter mais informações sobre sistemas operacionais, linguagens e arquiteturas com suporte, veja Suporte a linguagens e arquiteturas.

Ao usar a extensão IoT Edge do Visual Studio Code, você também pode iniciar e depurar o código do módulo no Simulador do IoT Edge.

Você também pode usar um computador de desenvolvimento do Windows e módulos de depuração em um contêiner do Linux usando o EFLOW (IoT Edge para Linux no Windows). Para obter mais informações de como usar o EFLOW para desenvolver módulos, confira Tutorial: desenvolver módulos do IoT Edge com contêineres do Linux usando o IoT Edge para Linux no Windows.

Se você não estiver familiarizado com as funcionalidades de depuração do Visual Studio Code, confira Depuração no Visual Studio Code.

Pré-requisitos

É possível usar um computador ou uma máquina virtual que execute Windows, macOS ou Linux como o computador de desenvolvimento. Em computadores Windows, você pode desenvolver módulos do Windows ou do Linux. Para desenvolver módulos do Linux, use um computador Windows que atenda aos requisitos da Área de Trabalho do Docker.

Para instalar as ferramentas necessárias para desenvolvimento e depuração, conclua o tutorial Desenvolver módulos do Azure IoT Edge com o tutorial do Visual Studio Code.

Instalar o Visual Studio Code

Adicione as seguintes extensões:

Extensão do Azure IoT Edge. A extensão das Ferramentas de Azure IoT Edge para Visual Studio Code está em modo de manutenção.
Extensão do Hub IoT do Azure.

Para depurar seu módulo em um dispositivo, você precisa:

Um Hub IoT ativo com pelo menos um dispositivo IoT Edge.
Um dispositivo IoT Edge físico ou um dispositivo virtual. Para criar um dispositivo virtual no Azure, siga as etapas no guia de início rápido para Linux.
Um módulo personalizado do IoT Edge. Para criar um módulo personalizado, siga as etapas no tutorial Desenvolver módulos do Azure IoT Edge com o tutorial do Visual Studio Code.

Depurar sem um contêiner usando o simulador do IoT Edge

O Simulador do IoT Edge é uma ferramenta que é executada em seu computador de desenvolvimento e simula o comportamento de um único dispositivo do IoT Edge. Use o Simulador do IoT Edge para desenvolver e testar os módulos do IoT Edge sem um dispositivo físico ou um runtime completo do dispositivo do IoT Edge.

As etapas de depuração a seguir pressupõem que um módulo personalizado já foi criado. Se ainda não criou um módulo personalizado, siga as etapas no tutorial Desenvolver módulos do Azure IoT Edge com o tutorial do Visual Studio Code.

A depuração de um módulo sem um contêiner não está disponível ao usar C ou Python.

O módulo requer o uso de um objeto ModuleClient no código do módulo padrão para que possa iniciar, executar e encaminhar mensagens. Você também usará o canal de entrada padrão Entrada1 para agir quando o módulo recebe mensagens.

Configurar o simulador de IoT Edge

Os módulos IoT Edge precisam de um ambiente do IoT Edge para execução e depuração. Você pode usar um simulador do IoT Edge no computador de desenvolvimento em vez de executar o subsistema de segurança e o runtime completos do IoT Edge. Você pode simular um dispositivo para depurar soluções com vários módulos ou simular um único aplicativo de módulo.

Opção 1: simular uma solução do IoT Edge:

Na guia Gerenciador no lado esquerdo, expanda a seção Hub IoT do Azure. Clique com o botão direito do mouse na ID do dispositivo do IoT Edge, e em seguida selecione Configurar simulador do IoT Edge para iniciar o simulador com a cadeia de conexão do dispositivo.
Você pode ver que o simulador do IoT Edge foi configurado com êxito lendo o detalhe de progresso no terminal integrado.

Opção 2: simular um só módulo do IoT Edge:

Na paleta de comandos do Visual Studio Code, execute o comando Azure IoT Edge: iniciar simulador do Hub do IoT Edge para módulo único.
Forneça os nomes das entradas que você quer testar com o módulo. Se você estiver usando o código de exemplo padrão, use o valor entrada1.
O comando disparará a CLI iotedgehubdev e iniciará o simulador IoT Edge e um contêiner de módulo de utilitário de teste. Você verá uma saída semelhante à seguinte no terminal integrado se o simulador tiver sido iniciado no modo de módulo único com êxito. A saída inclui um comando de exemplo curl para enviar uma mensagem ao simulador. Você usará o comando curl mais tarde.
```
D:\Workspaces\EdgeSolution>iotedgehubdev start -i "input1"
...
```
Você pode usar o modo de exibição do Explorador do Docker no Visual Studio Code para ver o status de execução do módulo.

O contêiner edgeHubDev é o núcleo do simulador de IoT Edge local. Ele pode ser executado no computador de desenvolvimento sem o daemon de segurança do IoT Edge e fornecer configurações de ambiente ao aplicativo de módulo nativo ou contêineres de módulo. O contêiner de entrada expôs as APIs de REST para ajudar a conectar as mensagens ao canal de entrada de destino no módulo.

Depurar o módulo Java no modo de inicialização

Depois que o simulador tiver sido iniciado com êxito, depure o código do módulo.

Prepare o ambiente para depuração, defina um ponto de interrupção no módulo e selecione a configuração de depuração a ser usada.

No terminal integrado do Visual Studio Code, altere o diretório para a pasta com o <nome do seu módulo> e execute o comando a seguir para compilar o aplicativo do .NET Core.

dotnet build

Caso esteja usando o módulo de amostra do tutorial, abra o arquivo ModuleBackgroundService.cs e adicione um ponto de interrupção.

Navegue até o modo de exibição de Depuração do Visual Studio Code selecionando o ícone de depuração no menu à esquerda ou digitando Ctrl+Shift+D. Selecione a configuração de depuração no <seu nome de módulo> Depuração Local (.NET Core) no menu suspenso.

Observação

Se o seu .NET Core TargetFramework não for consistente com seu caminho de programa em launch.json, você precisará atualizar manualmente o caminho de programa em launch.json para corresponder a TargetFramework no arquivo .csproj, para que o Visual Studio Code possa iniciar o programa com sucesso.

Selecione Iniciar Depuração ou pressione F5 para iniciar a sessão de depuração.
No terminal integrado do Visual Studio Code, execute o seguinte comando para enviar uma mensagem Olá, Mundo para o módulo. Este é o comando mostrado nas etapas anteriores ao configurar o simulador do IoT Edge.
```
curl --header "Content-Type: application/json" --request POST --data '{"inputName": "input1","data":"hello world"}' http://localhost:53000/api/v1/messages
```
Observação

Se você estiver usando o Windows, certificando-se de que o shell do terminal integrado do Visual Studio Code é Git Bash ou WSL Bash. Não é possível executar o comando curl no PowerShell ou no Prompt de Comando.
Na exibição de Depuração do Visual Studio Code, você verá as variáveis no painel esquerdo.
Para interromper a sessão de depuração, selecione o botão Parar ou pressione Shift + F5 e execute o comando Azure IoT Edge: parar simulador do IoT Edge por meio da paleta de comandos a fim de interromper o simulador e limpá-lo.

Configurar o simulador de IoT Edge

Opção 1: simular uma solução do IoT Edge:

Na guia Gerenciador no lado esquerdo, expanda a seção Hub IoT do Azure. Clique com o botão direito do mouse na ID do dispositivo do IoT Edge, e em seguida selecione Configurar simulador do IoT Edge para iniciar o simulador com a cadeia de conexão do dispositivo.
Você pode ver que o simulador do IoT Edge foi configurado com êxito lendo o detalhe de progresso no terminal integrado.

Opção 2: simular um só módulo do IoT Edge:

Na paleta de comandos do Visual Studio Code, execute o comando Azure IoT Edge: iniciar simulador do Hub do IoT Edge para módulo único.
Forneça os nomes das entradas que você quer testar com o módulo. Se você estiver usando o código de exemplo padrão, use o valor entrada1.
O comando disparará a CLI iotedgehubdev e iniciará o simulador IoT Edge e um contêiner de módulo de utilitário de teste. Você verá uma saída semelhante à seguinte no terminal integrado se o simulador tiver sido iniciado no modo de módulo único com êxito. A saída inclui um comando de exemplo curl para enviar uma mensagem ao simulador. Você usará o comando curl mais tarde.
```
D:\Workspaces\EdgeSolution>iotedgehubdev start -i "input1"
...
```
Você pode usar o modo de exibição do Explorador do Docker no Visual Studio Code para ver o status de execução do módulo.

O contêiner edgeHubDev é o núcleo do simulador de IoT Edge local. Ele pode ser executado no computador de desenvolvimento sem o daemon de segurança do IoT Edge e fornecer configurações de ambiente ao aplicativo de módulo nativo ou contêineres de módulo. O contêiner de entrada expôs as APIs de REST para ajudar a conectar as mensagens ao canal de entrada de destino no módulo.

Depurar o módulo Java no modo de inicialização

Depois que o simulador tiver sido iniciado com êxito, depure o código do módulo.

Prepare o ambiente para depuração, defina um ponto de interrupção no módulo e selecione a configuração de depuração a ser usada.

Adicione um ponto de interrupção ao código Java.

Selecione Iniciar Depuração ou pressione F5 para iniciar a sessão de depuração.
No terminal integrado do Visual Studio Code, execute o seguinte comando para enviar uma mensagem Olá, Mundo para o módulo. Este é o comando mostrado nas etapas anteriores ao configurar o simulador do IoT Edge.
```
curl --header "Content-Type: application/json" --request POST --data '{"inputName": "input1","data":"hello world"}' http://localhost:53000/api/v1/messages
```
Observação

Se você estiver usando o Windows, certificando-se de que o shell do terminal integrado do Visual Studio Code é Git Bash ou WSL Bash. Não é possível executar o comando curl no PowerShell ou no Prompt de Comando.
Na exibição de Depuração do Visual Studio Code, você verá as variáveis no painel esquerdo.
Para interromper a sessão de depuração, selecione o botão Parar ou pressione Shift + F5 e execute o comando Azure IoT Edge: parar simulador do IoT Edge por meio da paleta de comandos a fim de interromper o simulador e limpá-lo.

Configurar o simulador de IoT Edge

Opção 1: simular uma solução do IoT Edge:

Na guia Gerenciador no lado esquerdo, expanda a seção Hub IoT do Azure. Clique com o botão direito do mouse na ID do dispositivo do IoT Edge, e em seguida selecione Configurar simulador do IoT Edge para iniciar o simulador com a cadeia de conexão do dispositivo.
Você pode ver que o simulador do IoT Edge foi configurado com êxito lendo o detalhe de progresso no terminal integrado.

Opção 2: simular um só módulo do IoT Edge:

Na paleta de comandos do Visual Studio Code, execute o comando Azure IoT Edge: iniciar simulador do Hub do IoT Edge para módulo único.
Forneça os nomes das entradas que você quer testar com o módulo. Se você estiver usando o código de exemplo padrão, use o valor entrada1.
O comando disparará a CLI iotedgehubdev e iniciará o simulador IoT Edge e um contêiner de módulo de utilitário de teste. Você verá uma saída semelhante à seguinte no terminal integrado se o simulador tiver sido iniciado no modo de módulo único com êxito. A saída inclui um comando de exemplo curl para enviar uma mensagem ao simulador. Você usará o comando curl mais tarde.
```
D:\Workspaces\EdgeSolution>iotedgehubdev start -i "input1"
...
```
Você pode usar o modo de exibição do Explorador do Docker no Visual Studio Code para ver o status de execução do módulo.

O contêiner edgeHubDev é o núcleo do simulador de IoT Edge local. Ele pode ser executado no computador de desenvolvimento sem o daemon de segurança do IoT Edge e fornecer configurações de ambiente ao aplicativo de módulo nativo ou contêineres de módulo. O contêiner de entrada expôs as APIs de REST para ajudar a conectar as mensagens ao canal de entrada de destino no módulo.

Depurar o módulo Java no modo de inicialização

Depois que o simulador tiver sido iniciado com êxito, depure o código do módulo.

Prepare o ambiente para depuração, defina um ponto de interrupção no módulo e selecione a configuração de depuração a ser usada.

No terminal integrado do Visual Studio Code, altere o diretório para <sua pasta do nome do módulo> e execute o seguinte comando para instalar os pacotes de nó

npm install

Adicione um ponto de interrupção ao código Node.js.

Selecione Iniciar Depuração ou pressione F5 para iniciar a sessão de depuração.
No terminal integrado do Visual Studio Code, execute o seguinte comando para enviar uma mensagem Olá, Mundo para o módulo. Este é o comando mostrado nas etapas anteriores ao configurar o simulador do IoT Edge.
```
curl --header "Content-Type: application/json" --request POST --data '{"inputName": "input1","data":"hello world"}' http://localhost:53000/api/v1/messages
```
Observação

Se você estiver usando o Windows, certificando-se de que o shell do terminal integrado do Visual Studio Code é Git Bash ou WSL Bash. Não é possível executar o comando curl no PowerShell ou no Prompt de Comando.
Na exibição de Depuração do Visual Studio Code, você verá as variáveis no painel esquerdo.
Para interromper a sessão de depuração, selecione o botão Parar ou pressione Shift + F5 e execute o comando Azure IoT Edge: parar simulador do IoT Edge por meio da paleta de comandos a fim de interromper o simulador e limpá-lo.

Depurar no modo de anexação com o simulador do IoT Edge

C/Python
C#/Azure Functions/Node.js/Java

Não há suporte para depuração no modo de anexação para C ou Python.

Atualmente, depuração no modo de anexo é compatível somente conforme a seguir:

Módulos C#, inclusive módulos para o Azure Functions, dá suporte à depuração em contêineres de amd64 do Linux
Módulos Node.js dão suporte à depuração em contêineres Linux amd64 e arm32v7 e contêineres Windows amd64
Os módulos Java são compatíveis com depuração em contêineres Linux amd64 e arm32v7

Dica

Você pode alternar entre as opções para a plataforma padrão para sua solução IoT Edge clicando no item na barra de status do Visual Studio Code.

Configurar o simulador do IoT Edge para solução do IoT Edge

No computador de desenvolvimento, é possível iniciar o simulador do IoT Edge em vez de instalar o daemon de segurança do IoT Edge para que você possa executar a solução do IoT Edge.

Na guia Gerenciador no lado esquerdo, expanda a seção Hub IoT do Azure. Clique com o botão direito do mouse na ID do dispositivo do IoT Edge, e em seguida selecione Configurar simulador do IoT Edge para iniciar o simulador com a cadeia de conexão do dispositivo.
Visualize a configuração com êxito do Simulador IoT Edge lendo o detalhe de progresso no terminal integrado.

Compilar e executar contêiner para depuração e depuração em modo de anexação

Abra o arquivo de módulo e adicione um ponto de interrupção.
Na exibição do Visual Studio Code Explorer, clique com botão direito no deployment.debug.template.json arquivo para sua solução e, em seguida, selecione solução de compilação e execução do IoT Edge no simulador. É possível observar todos os logs de contêiner de módulo na mesma janela. Você também pode navegar para a exibição do Docker para observar o status do contêiner.
Navegue até a exibição de Depuração do Visual Studio Code e selecione o arquivo de configuração de depuração para o seu módulo. O nome da opção de depuração deve ser semelhante a <seu nome de módulo> Depuração Remota
Clique em Iniciar depuração ou pressione F5. Selecione o processo ao qual ele deverá ser anexado.
Na exibição de Depuração do Visual Studio Code, você visualiza as variáveis no painel esquerdo.
Para interromper a sessão de depuração, primeiro selecione o botão Parar ou pressione Shift + F5, depois execute o comando Azure IoT Edge: parar simulador do IoT Edge por meio da paleta de comandos.

Observação

O exemplo anterior mostra como depurar os módulos IoT Edge nos contêineres. Ele adicionou portas expostas às configurações createOptions de contêiner do módulo. Após concluir a depuração dos módulos, é recomendável remover essas portas expostas de módulos do IoT Edge prontos para produção.

Para módulos gravados em C#, incluindo o Azure Functions, ele é baseado na versão de depuração do Dockerfile.amd64.debug, que inclui o depurador de linha de comando do .NET Core (VSDBG) na imagem de contêiner durante a criação. Depois de depurar seus módulos C#, recomendamos que você use diretamente o Dockerfile sem VSDBG para módulos IoT Edge prontos para produção.

Depurar um módulo com o runtime do IoT Edge

Em cada pasta de módulo, há vários arquivos do Docker para diferentes tipos de contêiner. Use qualquer um dos arquivos que terminam com a extensão .debug para compilar o módulo para teste.

Durante a depuração de módulos usando esse método, os módulos são executados com base no runtime do IoT Edge. O dispositivo IoT Edge e o Visual Studio Code podem estar no mesmo computador ou, mais comumente, o Visual Studio Code está no computador de desenvolvimento e o runtime do IoT Edge e os módulos estão em execução em outro computador físico. Para depurar no Visual Studio Code, você deverá:

Configurar o dispositivo IoT Edge, compilar os módulos do IoT Edge com o Dockerfile .debug e depois implantar o dispositivo IoT Edge.
Atualizar o launch.json para que o Visual Studio Code possa se anexar ao processo em um contêiner no computador remoto. Encontre esse arquivo na pasta .vscode no espaço de trabalho, e ele atualiza sempre que você adiciona um novo módulo que dá suporte à depuração.
Use a depuração remota de SSH para fazer a anexação ao contêiner no computador remoto.

Compilar e implantar o módulo no dispositivo IoT Edge

No Visual Studio Code, abra o arquivo de manifesto de implantação deployment.debug.template.json. O manifesto de implantação descreve os módulos a serem configurados no dispositivo do IoT Edge de destino. Antes da implantação, você precisa atualizar as credenciais do Registro de Contêiner do Azure e as imagens de módulo com os valores de createOptions adequados. Para obter mais informações sobre os valores de createOption, confira Como configurar opções de criação de contêiner para módulos do IoT Edge.

Se você estiver usando um Registro de Contêiner do Azure para armazenar sua imagem de módulo, adicione suas credenciais à seção edgeAgent>configurações>registryCredentials em deployment.debug.template.json. Substitua myacr pelo seu próprio nome de registro em ambos os lugares e forneça sua senha e endereço do Servidor de logon. Por exemplo:

"modulesContent": {
"$edgeAgent": {
  "properties.desired": {
    "schemaVersion": "1.1",
    "runtime": {
      "type": "docker",
      "settings": {
        "minDockerVersion": "v1.25",
        "loggingOptions": "",
        "registryCredentials": {
          "myacr": {
            "username": "myacr",
            "password": "<your_azure_container_registry_password>",
            "address": "myacr.azurecr.io"
          }
        }
      }
    },
...

Adicione ou substitua o seguinte conteúdo com cadeia de caracteres ao valor createOptions para cada sistema (edgeHub e edgeAgent) e módulo personalizado (por exemplo, filtermodule) listado. Se necessário, mude os valores.

"createOptions": "{\"HostConfig\":{\"PortBindings\":{\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}],\"443/tcp\":[{\"HostPort\":\"443\"}]}}}"

Por exemplo a configuração filtermodule deve ser semelhante a:

"filtermodule": {
"version": "1.0",
"type": "docker",
"status": "running",
"restartPolicy": "always",
"settings": {
    "image": "myacr.azurecr.io/filtermodule:0.0.1-amd64",
    "createOptions": "{\"HostConfig\":{\"PortBindings\":{\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}],\"443/tcp\":[{\"HostPort\":\"443\"}]}}}"
}

Na paleta de comandos do Visual Studio Code, execute o comando Azure IoT Edge: Build and Push IoT Edge solution.
Selecione o deployment.debug.template.json arquivo para sua solução.
Na seção Dispositivos> Hub IoT do Azure da exibição Gerenciador do Visual Studio Code, clique com o botão direito do mouse no nome do dispositivo IoT Edge para implantação e escolha Criar Implantação para Dispositivo Único.

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.
Navegue até a pasta da sua solução config, selecione o arquivo deployment.debug.amd64.json e, em seguida, selecione Selecionar o manifesto de implantação de borda.

Verifique o status do contêiner no dispositivo ou máquina virtual executando o comando docker ps em um terminal. Você deverá visualizar o contêiner listado depois de executar o comando. Se o runtime do IoT Edge e Visual Studio Code estiver em execução no mesmo computador, você também poderá verificar o status na exibição do Docker do Visual Studio Code.

Importante

Caso esteja usando um registro privado como Registro de Contêiner do Azure para suas imagens, talvez seja necessário autenticar para enviar imagens por push. Use docker login <Azure Container Registry login server> ou az acr login --name <Azure Container Registry name> para autenticar.

Forneça suas credenciais de registro de contêiner para o Docker para que ele possa efetuar push de sua imagem de contêiner para ser armazenada no registro.

Entre no Docker com as credenciais do Registro de Contêiner do Azure que você salvou após criar o Registro.
```
docker login -u <Azure Container Registry username> -p <Azure Container Registry password> <Azure Container Registry login server>
```
Talvez você receba um aviso de segurança recomendando usar --password-stdin. Embora essa melhor prática seja recomendada para cenários de produção, ela não serve para este tutorial. Para saber mais, confira a referência de logon do docker.
Entre no Registro de Contêiner do Azure. Talvez seja necessário instalar a CLI do Azure para usar o comando az. Esse comando solicita o nome de usuário e a senha encontrados no registro de contêiner em Configurações>Chaves de acesso.
```
az acr login -n <Azure Container Registry name>
```

Dica

Se você fizer logon em qualquer momento nesse tutorial, repita as etapas acima de entrada do Docker e do Registro de Contêiner do Azure para continuar.

Criar imagem do Docker do módulo

Use o Dockerfile do módulo para criar a imagem do Docker do módulo.

docker build --rm -f "<DockerFilePath>" -t <ImageNameAndTag> "<ContextPath>"

Por exemplo, para criar a imagem do registro local ou de um Registro de Contêiner do Azure, use os seguintes comandos:

# Build the image for the local registry

docker build --rm -f "./modules/filtermodule/Dockerfile.amd64.debug" -t localhost:5000/filtermodule:0.0.1-amd64 "./modules/filtermodule"

# Or build the image for an Azure Container Registry

docker build --rm -f "./modules/filtermodule/Dockerfile.amd64.debug" -t myacr.azurecr.io/filtermodule:0.0.1-amd64 "./modules/filtermodule"

Enviar por push a imagem do Docker do módulo

Efetue push da imagem do módulo para o registro local ou para um registro de contêiner.

docker push <ImageName>

Por exemplo:

# Push the Docker image to the local registry

docker push localhost:5000/filtermodule:0.0.1-amd64

# Or push the Docker image to an Azure Container Registry
az acr login --name myacr
docker push myacr.azurecr.io/filtermodule:0.0.1-amd64

Implante o módulo no dispositivo IoT Edge

Use o comando IoT Edge Azure CLI set-modules para implantar os módulos no Hub IoT do Azure. Por exemplo, para implantar os módulos definidos no arquivo deployment.debug.template.json no Hub IoT my-iot-hub do dispositivo do IoT Edge my-device, use o seguinte comando:

az iot edge set-modules --hub-name my-iot-hub --device-id my-device --content ./deployment.debug.template.json --login "HostName=my-iot-hub.azure-devices.net;SharedAccessKeyName=iothubowner;SharedAccessKey=<SharedAccessKey>"

Dica

Encontre a chave de acesso compartilhada do Hub IoT no portal do Azure em >Configurações de segurança>Políticas de acesso compartilhado>iothubowner do Hub IoT.

Depurar seu aplicativo

Para depurar módulos em um dispositivo remoto, use a depuração SSH remota no Visual Studio Code.

Para habilitar a depuração remota do Visual Studio Code, instale a extensão de Desenvolvimento Remoto. Para obter mais informações sobre a depuração remota do Visual Studio Code, consulte Desenvolvimento Remoto do Visual Studio Code.

Para obter detalhes de como usar a depuração SSH remota no Visual Studio Code, confira Desenvolvimento remoto usando SSH

Na exibição Depuração do Visual Studio Code e selecione o arquivo de configuração de depuração para o seu módulo. Por padrão, o Dockerfile .debug, as configurações createOptions de contêiner do módulo e o arquivo launch.json usam localhost.

Selecione Iniciar Depuração ou selecione F5. Selecione o processo ao qual ele deverá ser anexado. Na exibição de Depuração do Visual Studio Code, você visualizará as variáveis no painel esquerdo.

Depurar usando o SSH remoto do Docker

Os mecanismos do Docker e do Moby dão suporte a conexões SSH com contêineres, permitindo a depuração no Visual Studio Code conectado a um dispositivo remoto. Você precisa atender aos pré-requisitos a seguir para poder usar esse recurso.

Os pré-requisitos de depuração de SSH remoto podem ser diferentes dependendo do linguagem que você está usando. As seções a seguir descrevem a configuração para .NET. Para obter informações sobre outras linguagens, consulte Desenvolvimento Remoto com o SSH, para obter uma visão geral. Detalhes sobre como configurar a depuração remota são incluídos nas seções de depuração para cada idioma na documentação do Visual Studio Code.

Configurar o túnel SSH do Docker

Siga as etapas em Túnel SSH do Docker para configurar o túnel SSH no computador de desenvolvimento. O túnel SSH requer a autenticação de par de chaves públicas/privadas e um contexto do Docker que defina o ponto de extremidade do dispositivo remoto.
A conexão ao Docker requer privilégios de nível raiz. Siga as etapas em Gerenciar o Docker como usuário não raiz para permitir a conexão com o daemon do Docker no dispositivo remoto. Ao terminar a depuração, você poderá remover o usuário do grupo do Docker.
No Visual Studio Code, use a Paleta de Comandos (Ctrl+Shift+P) para emitir o comando Docker Context: Use a fim de ativar o contexto do Docker apontando para o computador remoto. Este comando faz com que o Visual Studio Code e a CLI do Docker usem o contexto do computador remoto.

Dica

Todos os comandos do Docker usam o contexto atual. Lembre-se de alterar o contexto de volta ao padrão quando terminar a depuração.

Para verificar se o contexto remoto do Docker está ativo, liste os contêineres em execução no dispositivo remoto:

docker ps

A saída deve listar os contêineres em execução no dispositivo remoto semelhante a:

PS C:\> docker ps        
CONTAINER ID   IMAGE                                                             COMMAND                   CREATED        STATUS         PORTS                                                                                                                                   NAMES
a317b8058786   myacr.azurecr.io/filtermodule:0.0.1-amd64                         "dotnet filtermodule…"    24 hours ago   Up 6 minutes                                                                                                                                           filtermodule
d4d949f8dfb9   mcr.microsoft.com/azureiotedge-hub:1.5                            "/bin/sh -c 'echo \"$…"   24 hours ago   Up 6 minutes   0.0.0.0:443->443/tcp, :::443->443/tcp, 0.0.0.0:5671->5671/tcp, :::5671->5671/tcp, 0.0.0.0:8883->8883/tcp, :::8883->8883/tcp, 1883/tcp   edgeHub
1f0da9cfe8e8   mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.0   "/bin/sh -c 'echo \"$…"   24 hours ago   Up 6 minutes                                                                                                    
                                       tempSensor
66078969d843   mcr.microsoft.com/azureiotedge-agent:1.5                          "/bin/sh -c 'exec /a…"    24 hours ago   Up 6 minutes                                                                                                    
                                       edgeAgent

No diretório .vscode, adicione uma nova configuração para launch.json abrindo o arquivo no Visual Studio Code. Selecione Adicionar configuração e escolha o modelo de anexação remota correspondente do módulo. Por exemplo, a configuração a seguir é para o .NET Core. Altere o valor do parâmetro -H em PipeArgs para o nome DNS ou o endereço IP do dispositivo.

"configurations": [
{
  "name": "Remote Debug IoT Edge Module (.NET Core)",
  "type": "coreclr",
  "request": "attach",
  "processId": "${command:pickRemoteProcess}",
  "pipeTransport": {
    "pipeProgram": "docker",
    "pipeArgs": [
      "-H",
      "ssh://user@my-device-vm.eastus.cloudapp.azure.com:22",
      "exec",
      "-i",
      "filtermodule",
      "sh",
      "-c"
    ],
    "debuggerPath": "~/vsdbg/vsdbg",
    "pipeCwd": "${workspaceFolder}",
    "quoteArgs": true
  },
  "sourceFileMap": {
    "/app": "${workspaceFolder}/modules/filtermodule"
  },
  "justMyCode": true
},

Depurar o módulo remotamente

Na exibição Depuração do Visual Studio Code, selecione a configuração Depuração remota do módulo do IoT Edge (.NET Core).
Selecione Iniciar Depuração ou selecione F5. Selecione o processo ao qual ele deverá ser anexado.
Na exibição de Depuração do Visual Studio Code, visualize as variáveis no painel esquerdo.
No Visual Studio Code, defina pontos de interrupção no seu módulo personalizado.
Quando um ponto de interrupção é atingido, você pode inspecionar variáveis, percorrer o código e depurar o seu módulo.

Observação

O exemplo anterior mostra como depurar os módulos do IoT Edge em contêineres remotos. O exemplo adiciona um contexto remoto do Docker e alterações nos privilégios do Docker no dispositivo remoto. Depois de concluir a depuração dos módulos, defina o contexto do Docker como padrão e remova os privilégios da sua conta de usuário.

Confira esta entrada no blog do Desenvolvedor de IoT para ver um exemplo que usa um dispositivo Raspberry Pi.

Próximas etapas

Após compilar o módulo, saiba como implantar módulos do Azure IoT Edge.

Para desenvolver módulos para seus dispositivos do IoT Edge, consulte entender e usar os SDKs de Hub IoT do Azure.

Compartilhar via

Depurar módulos do Azure IoT Edge por meio do Visual Studio Code

Pré-requisitos

Depurar sem um contêiner usando o simulador do IoT Edge

Configurar o simulador de IoT Edge

Opção 1: simular uma solução do IoT Edge:

Opção 2: simular um só módulo do IoT Edge:

Depurar o módulo Java no modo de inicialização

Configurar o simulador de IoT Edge

Opção 1: simular uma solução do IoT Edge:

Opção 2: simular um só módulo do IoT Edge:

Depurar o módulo Java no modo de inicialização

Configurar o simulador de IoT Edge

Opção 1: simular uma solução do IoT Edge:

Opção 2: simular um só módulo do IoT Edge:

Depurar o módulo Java no modo de inicialização

Depurar no modo de anexação com o simulador do IoT Edge

Configurar o simulador do IoT Edge para solução do IoT Edge

Compilar e executar contêiner para depuração e depuração em modo de anexação

Depurar um módulo com o runtime do IoT Edge

Compilar e implantar o módulo no dispositivo IoT Edge

Criar imagem do Docker do módulo

Enviar por push a imagem do Docker do módulo

Implante o módulo no dispositivo IoT Edge

Depurar seu aplicativo

Depurar usando o SSH remoto do Docker

Configurar o túnel SSH do Docker

Depurar o módulo remotamente

Próximas etapas

Comentários

Recursos adicionais

Compartilhar via

Depurar módulos do Azure IoT Edge por meio do Visual Studio Code

Pré-requisitos

Depurar sem um contêiner usando o simulador do IoT Edge

Depurar no modo de anexação com o simulador do IoT Edge

Depurar um módulo com o runtime do IoT Edge

Compilar e implantar o módulo no dispositivo IoT Edge

Entrar no Docker

Criar imagem do Docker do módulo

Enviar por push a imagem do Docker do módulo

Implante o módulo no dispositivo IoT Edge

Depurar seu aplicativo

Depurar usando o SSH remoto do Docker

Configurar o túnel SSH do Docker

Depurar o módulo remotamente

Próximas etapas

Comentários

Recursos adicionais