Início Rápido: Implantar seu primeiro módulo do IoT Edge em um dispositivo virtual do WindowsQuickstart: Deploy your first IoT Edge module to a virtual Windows device

Experimente o Azure IoT Edge neste início rápido implantando um código em contêineres em um dispositivo virtual do Windows IoT Edge.Try out Azure IoT Edge in this quickstart by deploying containerized code to a virtual Windows IoT Edge device. O IoT Edge permite que você gerencie remotamente o código em seus dispositivos para que você possa enviar mais cargas de trabalho para a borda.IoT Edge allows you to remotely manage code on your devices so that you can send more of your workloads to the edge. Para este início rápido, recomendamos usar uma máquina virtual do Azure para o dispositivo do IoT Edge.For this quickstart, we recommend using an Azure virtual machine for your IoT Edge device. O uso de uma máquina virtual permite criar rapidamente um computador de teste, instalar os pré-requisitos e, em seguida, excluí-lo quando você terminar.Using a virtual machine allows you to quickly create a test machine, install the prerequisites, and then delete it when you're finished.

Neste guia de início rápido, você aprende a:In this quickstart you learn how to:

  • Crie um Hub IoT.Create an IoT hub.
  • Registrar um dispositivo IoT Edge em seu Hub IoT.Register an IoT Edge device to your IoT hub.
  • Instale e inicie o runtime do IoT Edge no dispositivo virtual.Install and start the IoT Edge runtime on your virtual device.
  • Implante remotamente um módulo em um dispositivo IoT Edge e envie a telemetria para IoT Hub.Remotely deploy a module to an IoT Edge device and send telemetry to IoT Hub.

Diagrama – Início Rápido da arquitetura para dispositivo e nuvem

Este início rápido explica como criar uma máquina virtual do Windows e configurá-la como um dispositivo IoT Edge.This quickstart walks you through creating a Windows virtual machine and configuring it to be an IoT Edge device. Em seguida, implante um módulo do portal do Azure em seu dispositivo.Then, you deploy a module from the Azure portal to your device. O módulo usado neste guia de início rápido é um sensor simulado que gera dados de temperatura, umidade e pressão.The module used in this quickstart is a simulated sensor that generates temperature, humidity, and pressure data. Os outros tutoriais do Azure IoT Edge se baseiam no trabalho feito aqui com a implantação de módulos adicionais que analisam os dados simulados para obter informações de negócios.The other Azure IoT Edge tutorials build upon the work you do here by deploying additional modules that analyze the simulated data for business insights.

Se você não tiver uma assinatura do Azure ativa, crie uma conta gratuita antes de começar.If you don't have an active Azure subscription, create a free account before you begin.

Usar o Azure Cloud ShellUse Azure Cloud Shell

O Azure hospeda o Azure Cloud Shell, um ambiente de shell interativo que pode ser usado por meio do navegador.Azure hosts Azure Cloud Shell, an interactive shell environment that you can use through your browser. É possível usar o bash ou o PowerShell com o Cloud Shell para trabalhar com os serviços do Azure.You can use either Bash or PowerShell with Cloud Shell to work with Azure services. É possível usar os comandos pré-instalados do Cloud Shell para executar o código neste artigo sem precisar instalar nada no seu ambiente local.You can use the Cloud Shell preinstalled commands to run the code in this article without having to install anything on your local environment.

Para iniciar o Azure Cloud Shell:To start Azure Cloud Shell:

OpçãoOption Exemplo/LinkExample/Link
Selecione Experimente no canto superior direito de um bloco de código.Select Try It in the upper-right corner of a code block. Selecionar Experimente não copia automaticamente o código para o Cloud Shell.Selecting Try It doesn't automatically copy the code to Cloud Shell. Exemplo de “Experimente” no Azure Cloud Shell
Acesse https://shell.azure.com ou selecione o botão Iniciar o Cloud Shell para abri-lo no navegador.Go to https://shell.azure.com, or select the Launch Cloud Shell button to open Cloud Shell in your browser. Inicie o Cloud Shell em uma nova janelaLaunch Cloud Shell in a new window
Selecione o botão Cloud Shell na barra de menus no canto superior direito do portal do Azure.Select the Cloud Shell button on the menu bar at the upper right in the Azure portal. Botão Cloud Shell no portal do Azure

Para executar o código neste artigo no Azure Cloud Shell:To run the code in this article in Azure Cloud Shell:

  1. Inicie o Cloud Shell.Start Cloud Shell.

  2. Clique no botão Copiar no bloco de código para copiá-lo.Select the Copy button on a code block to copy the code.

  3. Cole o código na sessão do Cloud Shell ao pressionar Ctrl+Shift+V no Windows e no Linux ou Cmd+Shift+V no macOS.Paste the code into the Cloud Shell session by selecting Ctrl+Shift+V on Windows and Linux or by selecting Cmd+Shift+V on macOS.

  4. Pressione Enter para executar o código.Select Enter to run the code.

Você usa a CLI do Azure para concluir muitas das etapas neste guia de início rápido.You use the Azure CLI to complete many of the steps in this quickstart. O Azure IoT tem uma extensão para habilitar funcionalidade adicional.Azure IoT has an extension to enable additional functionality.

Adicione a extensão de IoT do Azure à instância do Cloud Shell.Add the Azure IoT extension to the Cloud Shell instance.

az extension add --name azure-iot

Observação

Este artigo usa a versão mais recente da extensão de IoT do Azure, chamada azure-iot.This article uses the newest version of the Azure IoT extension, called azure-iot. A versão herdada chama-se azure-cli-iot-ext. Você deve ter apenas uma versão instalada por vez.The legacy version is called azure-cli-iot-ext.You should only have one version installed at a time. Use o comando az extension list para validar quais extensões estão instaladas.You can use the command az extension list to validate the currently installed extensions.

Use az extension remove --name azure-cli-iot-ext para remover a versão herdada da extensão.Use az extension remove --name azure-cli-iot-ext to remove the legacy version of the extension.

Use az extension add --name azure-iot para adicionar a nova versão da extensão.Use az extension add --name azure-iot to add the new version of the extension.

Para ver quais extensões você tem instaladas, use az extension list.To see what extensions you have installed, use az extension list.

Pré-requisitosPrerequisites

Recursos de nuvem:Cloud resources:

  • Um grupo de recursos para gerenciar todos os recursos que você usará neste início rápido.A resource group to manage all the resources you use in this quickstart.

    az group create --name IoTEdgeResources --location westus2
    

Dispositivo IoT Edge:IoT Edge device:

  • Uma máquina virtual do Windows para atuar como o dispositivo IoT Edge.A Windows virtual machine to act as your IoT Edge device. É possível criar essa máquina virtual usando o seguinte comando, substituindo {password} por uma senha segura:You can create this virtual machine using the following command, replacing {password} with a secure password:

    az vm create --resource-group IoTEdgeResources --name EdgeVM --image MicrosoftWindowsDesktop:Windows-10:rs5-pro:latest --admin-username azureuser --admin-password {password} --size Standard_DS1_v2
    

    A criação e a inicialização da nova máquina virtual podem levar alguns minutos.It may take a few minutes to create and start the new virtual machine.

    Depois que a máquina virtual for iniciada, baixe um arquivo RDP para usá-lo quando você se conectar à máquina virtual:Once your virtual machine starts, you can download an RDP file for use when connecting to your virtual machine:

    1. Navegue até a nova máquina virtual do Windows no portal do Azure.Navigate to your new Windows virtual machine in the Azure portal.
    2. Selecione Conectar.Select Connect.
    3. Na guia RDP, selecione Baixar arquivo RDP.On the RDP tab, select Download RDP File.

    Abra esse arquivo com Conexão de Área de Trabalho Remota para conectar-se à máquina virtual do Windows usando o nome do administrador e senha que você especificou com o comando az vm create.Open this file with Remote Desktop Connection to connect to your Windows virtual machine using the administrator name and password you specified with the az vm create command.

Observação

Sua máquina virtual do Windows começa com o Windows versão 1809 (build 17763), que é o último build de suporte de longo prazo do Windows.Your Windows virtual machine starts with Windows version 1809 (build 17763), which is the latest Windows long-term support build. Por padrão, o Windows verifica automaticamente se há atualizações a cada 22 horas.Windows automatically checks for updates every 22 hours by default. Após uma verificação na sua máquina virtual, o Windows envia por push uma atualização de versão que é incompatível com o IoT Edge para Windows, o que impede o uso posterior de recursos do IoT Edge para Windows.After a check on your virtual machine, Windows pushes a version update that is incompatible with IoT Edge for Windows, which prevents further use of IoT Edge for Windows features. Recomendamos limitar o uso da máquina virtual a um período que não exceda 22 horas ou pausar temporariamente as atualizações do Windows.We recommend limiting use of your virtual machine to within 22 hours or temporarily pausing Windows updates.

Este início rápido usa uma máquina virtual da área de trabalho do Windows para manter a simplicidade.This quickstart uses a Windows desktop virtual machine for simplicity. Para saber mais sobre quais sistemas operacionais do Windows estão geralmente disponíveis para cenários de produção, confira Sistemas com suporte do Azure IoT Edge.For information about which Windows operating systems are generally available for production scenarios, see Azure IoT Edge supported systems.

Caso deseje configurar seu dispositivo Windows para o IoT Edge, incluindo dispositivos que executam o IoT Core, siga as etapas descritas em Instalar o runtime do Azure IoT Edge.If you want to configure your own Windows device for IoT Edge, including devices running IoT Core, follow the steps in Install the Azure IoT Edge runtime.

Crie um hub IoTCreate an IoT hub

Comece o início rápido criando um Hub IoT com a CLI do Azure.Start the quickstart by creating an IoT hub with Azure CLI.

Diagrama – Criar um hub IoT na nuvem

O nível gratuito do Hub IoT funciona para este guia de início rápido.The free level of IoT Hub works for this quickstart. Se você tiver usado o Hub IoT antes e já tiver um hub criado, poderá usar esse Hub IoT.If you've used IoT Hub in the past and already have a hub created, you can use that IoT hub.

O código a seguir cria um hub F1 disponível no grupo de recursos IoTEdgeResources.The following code creates a free F1 hub in the resource group IoTEdgeResources. Substitua {hub_name} por um nome exclusivo para o hub IoT.Replace {hub_name} with a unique name for your IoT hub. A criação de um Hub IoT pode demorar alguns minutos.It might take a few minutes to create an IoT Hub.

az iot hub create --resource-group IoTEdgeResources --name {hub_name} --sku F1 --partition-count 2

Se você receber um erro porque já exsite um hub gratuito na sua assinatura, altere o SKU para S1.If you get an error because there's already one free hub in your subscription, change the SKU to S1. Caso você receba um erro que o nome do Hub IoT não está disponível, isso significa que alguém já tem um hub com esse nome.If you get an error that the IoT Hub name isn't available, it means that someone else already has a hub with that name. Tente usar um novo nome.Try a new name.

Registrar um dispositivo IoT EdgeRegister an IoT Edge device

Registre um dispositivo IoT Edge no Hub IoT recém-criado.Register an IoT Edge device with your newly created IoT hub. Diagrama – Registrar um dispositivo com uma identidade do Hub IoTDiagram - Register a device with an IoT Hub identity

Crie uma identidade de dispositivo para seu dispositivo simulado para que ele possa se comunicar com o hub IoT.Create a device identity for your simulated device so that it can communicate with your IoT hub. A identidade do dispositivo reside na nuvem e você usa uma cadeia de conexão de dispositivo exclusiva para associar um dispositivo físico a uma identidade do dispositivo.The device identity lives in the cloud, and you use a unique device connection string to associate a physical device to a device identity.

Como os dispositivos IoT Edge se comportam e podem ser gerenciados diferentemente de dispositivos IoT comuns, declare essa identidade para ser um dispositivo IoT Edge com o sinalizador --edge-enabled.Since IoT Edge devices behave and can be managed differently than typical IoT devices, declare this identity to be for an IoT Edge device with the --edge-enabled flag.

  1. No Azure Cloud Shell, digite o comando a seguir para criar um dispositivo denominado myEdgeDevice no seu hub.In the Azure Cloud Shell, enter the following command to create a device named myEdgeDevice in your hub.

    az iot hub device-identity create --device-id myEdgeDevice --edge-enabled --hub-name {hub_name}
    

    Se você receber um erro sobre as chaves de política do iothubowner, verifique se o Cloud Shell está executando a última versão da extensão azure-iot.If you get an error about iothubowner policy keys, make sure that your Cloud Shell is running the latest version of the azure-iot extension.

  2. Veja a cadeia de conexão para o seu dispositivo, o que vincula o dispositivo físico à sua identidade no Hub IoT.View the connection string for your device, which links your physical device with its identity in IoT Hub. Ele contém o nome do seu hub IoT, o nome do seu dispositivo e uma chave compartilhada que autentica as conexões entre os dois.It contains the name of your IoT hub, the name of your device, and then a shared key that authenticates connections between the two.

    az iot hub device-identity show-connection-string --device-id myEdgeDevice --hub-name {hub_name}
    
  3. Copie o valor da chave connectionString da saída JSON e salve-o.Copy the value of the connectionString key from the JSON output and save it. Esse valor é a cadeia de conexão do dispositivo.This value is the device connection string. Você usará essa cadeia de conexão para configurar o tempo de execução do IoT Edge na próxima seção.You'll use this connection string to configure the IoT Edge runtime in the next section.

    Recuperar a cadeia de conexão da saída da CLI

Instalar e iniciar o runtime do IoT EdgeInstall and start the IoT Edge runtime

Instale o runtime do Azure IoT Edge no dispositivo IoT Edge e configure-o com uma cadeia de conexão do dispositivo.Install the Azure IoT Edge runtime on your IoT Edge device and configure it with a device connection string. Diagrama – Iniciar o runtime no dispositivoDiagram - Start the runtime on device

O runtime do IoT Edge é implantado em todos os dispositivos IoT Edge.The IoT Edge runtime is deployed on all IoT Edge devices. Tem três componentes.It has three components. O daemon de segurança do IoT Edge é iniciado sempre que um dispositivo IoT Edge é iniciado e inicializa o dispositivo inicializando o agente do IoT Edge.The IoT Edge security daemon starts each time an IoT Edge device boots and bootstraps the device by starting the IoT Edge agent. O agente do IoT Edge gerencia a implantação e o monitoramento de módulos no dispositivo IoT Edge, incluindo o hub do IoT Edge.The IoT Edge agent manages deployment and monitoring of modules on the IoT Edge device, including the IoT Edge hub. O hub do IoT Edge controla a comunicação entre os módulos no dispositivo IoT Edge e entre o dispositivo e o Hub IoT.The IoT Edge hub handles communications between modules on the IoT Edge device, and between the device and IoT Hub.

O script de instalação também inclui um mecanismo de contêiner chamado Moby que gerencia as imagens de contêiner no seu dispositivo IoT Edge.The installation script also includes a container engine called Moby that manages the container images on your IoT Edge device.

Durante a instalação do runtime, você precisará fornecer uma cadeia de conexão do dispositivo.During the runtime installation, you're asked for a device connection string. Use a cadeia de caracteres que você recuperou da CLI do Azure.Use the string that you retrieved from the Azure CLI. Essa cadeia de caracteres associa seu dispositivo físico à identidade do dispositivo IoT Edge no Azure.This string associates your physical device with the IoT Edge device identity in Azure.

Conectar-se ao dispositivo do IoT EdgeConnect to your IoT Edge device

Todas as etapas desta seção ocorrem no dispositivo IoT Edge, portanto, conecte-se à máquina virtual via área de trabalho remota.The steps in this section all take place on your IoT Edge device, so you want to connect to that virtual machine now via remote desktop.

Instalar e configurar o serviço do IoT EdgeInstall and configure the IoT Edge service

Use o PowerShell para baixar e instalar o runtime do IoT Edge.Use PowerShell to download and install the IoT Edge runtime. Use a cadeia de conexão do dispositivo que você recuperou do Hub IoT para configurar o dispositivo.Use the device connection string that you retrieved from IoT Hub to configure your device.

  1. Na máquina virtual, execute o PowerShell como administrador.In the virtual machine, run PowerShell as an administrator.

    Observação

    Use uma sessão do AMD64 do PowerShell para instalar o IoT Edge e não o PowerShell (x86).Use an AMD64 session of PowerShell to install IoT Edge, not PowerShell (x86). Se não tiver certeza de qual tipo de sessão você está usando, execute o seguinte comando:If you're not sure which session type you're using, run the following command:

    (Get-Process -Id $PID).StartInfo.EnvironmentVariables["PROCESSOR_ARCHITECTURE"]
    
  2. O comando Deploy-IoTEdge verifica se seu computador Windows está usando uma versão compatível, ativa o recurso de contêineres, baixa o tempo de execução do Moby e do IoT Edge.The Deploy-IoTEdge command checks that your Windows machine is on a supported version, turns on the containers feature, downloads the Moby runtime, and then downloads the IoT Edge runtime.

    . {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; `
    Deploy-IoTEdge -ContainerOs Windows
    
  3. O computador poderá ser reiniciado automaticamente.Your machine may restart automatically. Se você for solicitado pelo comando Deploy-IoTEdge a reinicializar, faça isso agora.If you are prompted by the Deploy-IoTEdge command to reboot, do so now.

  4. Execute novamente o PowerShell como administrador.Run PowerShell as an administrator again.

  5. O comando Initialize-IoTEdge configura o runtime do IoT Edge em seu computador.The Initialize-IoTEdge command configures the IoT Edge runtime on your machine. O comando assumirá como padrão o provisionamento manual com contêineres do Windows.The command defaults to manual provisioning with Windows containers.

    . {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; `
    Initialize-IoTEdge -ContainerOs Windows
    
  6. Quando solicitado a fornecer uma DeviceConnectionString, forneça a cadeia de caracteres que você copiou na seção anterior.When prompted for a DeviceConnectionString, provide the string that you copied in the previous section. Não inclua aspas na cadeia de conexão.Don't include quotes around the connection string.

Veja o status do runtime do IoT EdgeView the IoT Edge runtime status

Verifique se o runtime foi instalado e configurado com êxito.Verify that the runtime was successfully installed and configured. Pode levar alguns minutos para a instalação ser concluída e o módulo do agente do IoT Edge iniciar.It may take a few minutes for the installation to complete and the IoT Edge agent module to start.

  1. Verifique o status do serviço do IoT Edge.Check the status of the IoT Edge service.

    Get-Service iotedge
    
  2. Se você precisar solucionar problemas do serviço, recupere os logs de serviço.If you need to troubleshoot the service, retrieve the service logs.

    . {Invoke-WebRequest -useb aka.ms/iotedge-win} | Invoke-Expression; Get-IoTEdgeLog
    
  3. Exiba todos os módulos em execução no seu dispositivo IoT Edge.View all the modules running on your IoT Edge device. Como o serviço acabou de ser iniciado pela primeira vez, você só verá o módulo edgeAgent em execução.Since the service just started for the first time, you should only see the edgeAgent module running. O módulo edgeAgent é executado por padrão e ajuda a instalar e a iniciar quaisquer módulos adicionais que você implante em seu dispositivo.The edgeAgent module runs by default and helps to install and start any additional modules that you deploy to your device.

    iotedge list
    

    Exibir um módulo no dispositivo

Seu dispositivo IoT Edge agora está configurado.Your IoT Edge device is now configured. Ele está pronto para executar os módulos implantados na nuvem.It's ready to run cloud-deployed modules.

Implantar um móduloDeploy a module

Gerencie o dispositivo Azure IoT Edge na nuvem para implantar um módulo que envia dados telemétricos ao Hub IoT.Manage your Azure IoT Edge device from the cloud to deploy a module that sends telemetry data to IoT Hub.

Diagrama – Implantar o módulo da nuvem para dispositivo

Um dos principais recursos do Azure IoT Edge é a possibilidade de implantar código em seus dispositivos IoT Edge na nuvem.One of the key capabilities of Azure IoT Edge is being able to deploy code to your IoT Edge devices from the cloud. Módulos do IoT Edge são pacotes executáveis implementados como contêineres.IoT Edge modules are executable packages implemented as containers. Nesta seção, você implanta um módulo pré-criado na seção Módulos do IoT Edge do Azure Marketplace diretamente de seu Hub IoT do Azure.In this section, you deploy a pre-built module from the IoT Edge Modules section of the Azure Marketplace directly from your Azure IoT Hub.

O módulo que você implanta nesta seção simula um sensor e envia os dados gerados.The module that you deploy in this section simulates a sensor and sends generated data. Esse módulo é uma informação útil de código quando você estiver começando a usar o IoT Edge porque você pode usar os dados simulados para desenvolvimento e teste.This module is a useful piece of code when you're getting started with IoT Edge because you can use the simulated data for development and testing. Se quiser ver exatamente o que esse módulo faz, você poderá exibir o código-fonte do sensor de temperatura simulado.If you want to see exactly what this module does, you can view the simulated temperature sensor source code.

Para implantar seu primeiro módulo do Azure Marketplace, use as seguintes etapas:To deploy your first module from the Azure Marketplace, use the following steps:

  1. Entre no Portal do Azure e navegue até o Hub IoT.Sign in to the Azure portal and navigate to your IoT hub.

  2. No menu no painel esquerdo, em Gerenciamento Automático de Dispositivo, selecione IoT Edge.From the menu on the left pane, under Automatic Device Management, select IoT Edge.

  3. Clique na ID do dispositivo alvo da lista de dispositivos.Click on the device ID of the target device from the list of devices.

  4. Na barra superior, selecione Definir Módulos.On the upper bar, select Set Modules.

    Selecionar Definir Módulos na página de detalhes do dispositivo

  5. Na seção Módulos do IoT Edge da página, clique em Adicionar e selecione Módulo do Marketplace no menu suspenso.In the IoT Edge Modules section of the page, click Add and select Marketplace Module from the drop-down menu.

    Adicionar módulo do Marketplace

  6. Em Marketplace do Módulo do IoT Edge, pesquise "Sensor de Temperatura Simulado" e selecione esse módulo.In the IoT Edge Module Marketplace, search for "Simulated Temperature Sensor" and select that module.

  7. Observe que o módulo SimulatedTemperatureSensor é adicionado à seção Módulos do IoT Edge, com o status desejado Em execução.Notice that the SimulatedTemperatureSensor module is added to the IoT Edge Modules section, with the desired status running.

    Selecione Avançar: Rotas para prosseguir para a próxima etapa do assistente.Select Next: Routes to continue to the next step of the wizard.

    Vá para a próxima etapa depois que o módulo do sensor de temperatura estiver listado

  8. Na guia Rotas do assistente, você pode definir como as mensagens são transmitidas entre os módulos e o Hub IoT.On the Routes tab of the wizard, you can define how messages are passed between modules and the IoT Hub. As rotas são construídas usando pares nome/valor.Routes are constructed using name/value pairs. Você verá duas rotas nessa página.You should see two routes on this page. A rota padrão chamada rota envia todas as mensagens ao Hub IoT (que é chamado $upstream).The default route called route sends all messages to IoT Hub (which is called $upstream). Uma segunda rota chamada SimulatedTemperatureSensorToIoTHub foi criada automaticamente quando você adicionou o módulo do Marketplace.A second route called SimulatedTemperatureSensorToIoTHub was created automatically when you added the module from the Marketplace. Essa rota envia todas as mensagens especificamente do módulo de temperatura simulada para o Hub IoT.This route sends all messages specifically from the simulated temperature module to IoT Hub. Você pode excluir a rota padrão porque ela é redundante nesse caso.You can delete the default route because it's redundant in this case.

    Selecione Avançar: Examinar + criar para continuar e ir para a próxima etapa do assistente.Select Next: Review + create to continue to the next step of the wizard.

    Exclua a rota padrão e vá para a próxima etapa

  9. Na guia Examinar + criar do assistente, você pode visualizar o arquivo JSON que define todos os módulos implantados no dispositivo IoT Edge.On the Review + create tab of the wizard, you can preview the JSON file that defines all the modules that get deployed to your IoT Edge device. Observe que o módulo SimulatedTemperatureSensor está incluído, bem como os dois módulos de runtime, edgeAgent e edgeHub.Notice that the SimulatedTemperatureSensor module is included as well as the two runtime modules, edgeAgent and edgeHub. Selecione Criar quando terminar de examinar.Select Create when you're done reviewing.

    Quando você envia uma nova implantação para um dispositivo IoT Edge, nada é enviado por push para o dispositivo.When you submit a new deployment to an IoT Edge device, nothing is pushed to your device. Em vez disso, o dispositivo consulta o Hub IoT regularmente para verificar se há novas instruções.Instead, the device queries IoT Hub regularly for any new instructions. Se o dispositivo encontrar um manifesto de implantação atualizada, ele usará as informações sobre a nova implantação para efetuar pull das imagens de módulo da nuvem e, em seguida, começa a executar os módulos localmente.If the device finds an updated deployment manifest, it uses the information about the new deployment to pull the module images from the cloud then starts running the modules locally. Esse processo pode levar alguns minutos.This process may take a few minutes.

  10. Depois que você criar os detalhes de implantação do módulo, o assistente direcionará você à página de detalhes do dispositivo.After you create the module deployment details, the wizard returns you to the device details page. Na página de detalhes do dispositivo, veja o status da implantação na guia Módulos. Três módulos deverão estar listados: $edgeAgent, $edgeHub e SimulatedTemperatureSensor.On the device details page, view the deployment status in the Modules tab. Three modules should be listed: $edgeAgent, $edgeHub, and SimulatedTemperatureSensor. Se um ou mais módulos estão listados conforme especificado na implantação, mas não são relatados pelo dispositivo, o dispositivo IoT Edge ainda está iniciando os módulos.If one or more of the modules are listed as specified in deployment but not reported by device, your IoT Edge device is still starting them. Aguarde alguns instantes e selecione Atualizar na parte superior da página.Wait a few moments and select Refresh at the top of the page.

    Exibir SimulatedTemperatureSensor na lista de módulos implantados

Exibir os dados geradosView generated data

Neste guia de início rápido, você criou um novo dispositivo IoT Edge e instalou o runtime do IoT Edge nele.In this quickstart, you created a new IoT Edge device and installed the IoT Edge runtime on it. Em seguida, você usou o portal do Azure para implantar um módulo do IoT Edge para ser executado no dispositivo sem precisar fazer alterações no próprio dispositivo.Then, you used the Azure portal to deploy an IoT Edge module to run on the device without having to make changes to the device itself.

Nesse caso, o módulo enviado por push gera dados de ambiente de exemplo que você pode usar para testar mais tarde.In this case, the module that you pushed generates sample environment data that you can use for testing later. O sensor simulado está monitorando um computador e o ambiente em torno do computador.The simulated sensor is monitoring both a machine and the environment around the machine. Por exemplo, esse sensor pode estar em uma sala de servidor, em um chão de fábrica ou em uma turbina eólica.For example, this sensor might be in a server room, on a factory floor, or on a wind turbine. A mensagem inclui a temperatura ambiente e umidade, temperatura do computador, pressão e um carimbo de data/hora.The message includes ambient temperature and humidity, machine temperature and pressure, and a timestamp. Os tutoriais do IoT Edge usam os dados criados por esse módulo de dados de teste para análise.The IoT Edge tutorials use the data created by this module as test data for analytics.

Confirme se o módulo implantado da nuvem está em execução no seu dispositivo IoT Edge.Confirm that the module deployed from the cloud is running on your IoT Edge device.

iotedge list

Exibir três módulos no seu dispositivo

Exiba as mensagens que estão sendo enviadas do módulo sensor de temperatura para a nuvem.View the messages being sent from the temperature sensor module to the cloud.

iotedge logs SimulatedTemperatureSensor -f

Dica

Ao fazer referência a nomes de módulo, comandos do IoT Edge diferenciam maiúsculas de minúsculas.IoT Edge commands are case-sensitive when referring to module names.

Exibir os dados do seu módulo

Você também pode exibir as mensagens que são recebidas pelo seu hub IoT usando a Extensão do Hub IoT do Azure para o Visual Studio Code.You can also watch the messages arrive at your IoT hub by using the Azure IoT Hub extension for Visual Studio Code.

Limpar os recursosClean up resources

Se você deseja prosseguir para os tutoriais do IoT Edge, pode usar o dispositivo registrado e configurado neste guia de início rápido.If you want to continue on to the IoT Edge tutorials, you can use the device that you registered and set up in this quickstart. Caso contrário, você pode excluir os recursos do Azure que criou para evitar encargos.Otherwise, you can delete the Azure resources that you created to avoid charges.

Se você tiver criado a sua máquina virtual e o Hub IoT em um novo grupo de recursos, é possível excluir esse grupo e todos os recursos associados.If you created your virtual machine and IoT hub in a new resource group, you can delete that group and all the associated resources. Verifique novamente o conteúdo do grupo de recursos para ter certeza de que não haja nada que você queira manter.Double check the contents of the resource group to make sure that there's nothing you want to keep. Caso não queira excluir o grupo inteiro, é possível excluir recursos individuais em vez disso.If you don't want to delete the whole group, you can delete individual resources instead.

Importante

A exclusão de um grupo de recursos é irreversível.Deleting a resource group is irreversible.

Remova o grupo IoTEdgeResources.Remove the IoTEdgeResources group. A exclusão de um grupo de recursos pode demorar alguns minutos.It might take a few minutes to delete a resource group.

az group delete --name IoTEdgeResources

Para confirmar se o grupo de recursos foi removido, veja a lista de grupos de recursos.You can confirm the resource group is removed by viewing the list of resource groups.

az group list

Próximas etapasNext steps

Neste início rápido, você criou um dispositivo IoT Edge e usou a interface de nuvem do Azure IoT Edge para implantar código no dispositivo.In this quickstart, you created an IoT Edge device and used the Azure IoT Edge cloud interface to deploy code onto the device. Agora, você tem um dispositivo de teste que gera dados brutos sobre seu ambiente.Now, you have a test device generating raw data about its environment.

A próxima etapa é configurar seu ambiente de desenvolvimento local para que você possa começar a criar módulos de IoT Edge que executem a sua lógica de negócios.The next step is to set up your local development environment so that you can start creating IoT Edge modules that run your business logic.