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

Teste o Azure IoT Edge neste início rápido implantando um código em contêineres em um dispositivo virtual Linux do IoT Edge.Test out Azure IoT Edge in this quickstart by deploying containerized code to a virtual Linux 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 o uso de uma máquina virtual do Azure para o dispositivo do IoT Edge, o que permitirá criar rapidamente um computador de teste com o serviço IoT Edge instalado e excluí-lo quando você terminar.For this quickstart, we recommend using an Azure virtual machine for your IoT Edge device, which allows you to quickly create a test machine with the IoT Edge service installed 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.
  • Implantar um módulo em um dispositivo IoT Edge remotamente.Remotely deploy a module to an IoT Edge device.

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

Este Início Rápido orienta você pela criação de uma máquina virtual Linux configurada para ser um dispositivo do IoT Edge.This quickstart walks you through creating a Linux virtual machine that's configured 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 e o Azure IoT possui uma extensão para habilitar funcionalidades adicionais.You use the Azure CLI to complete many of the steps in this quickstart, and 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. Usamos o nome do grupo de recursos de exemplo IoTEdgeResources em todo este guia de início rápido e nos tutoriais a seguir.We use the example resource group name IoTEdgeResources throughout this quickstart and the following tutorials.

    az group create --name IoTEdgeResources --location westus2
    

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 gratuito 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. Cada assinatura pode ter somente um hub IoT gratuito.Each subscription can only have one free IoT hub. 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 IoT

Crie uma identidade do dispositivo para seu dispositivo IoT Edge para que ele possa se comunicar com o hub IoT.Create a device identity for your IoT Edge 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. Vamos nos referir a essa cadeia de conexão novamente na próxima seção quando você configurar seu dispositivo do IoT Edge.We'll refer to this connection string again in the next section when you set up your IoT Edge device.

    az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name {hub_name}
    

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

Configurar o dispositivo IoT EdgeConfigure your IoT Edge device

Crie uma máquina virtual com o Azure runtime do IoT Edge nela.Create a virtual machine with the Azure IoT Edge runtime on it.

Diagrama – iniciar o runtime no dispositivo

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 facilita a implantação e o monitoramento de módulos no dispositivo IoT Edge, incluindo o hub do IoT Edge.The IoT Edge agent facilitates deployment and monitoring of modules on the IoT Edge device, including the IoT Edge hub. O hub IoT Edge gerencia a comunicação entre os módulos no dispositivo IoT Edge e entre o dispositivo e o Hub IoT.The IoT Edge hub manages communications between modules on the IoT Edge device, and between the device and IoT Hub.

Durante a configuração do runtime, você precisa fornecer uma cadeia de conexão do dispositivo.During the runtime configuration, you provide a device connection string. Essa é a cadeia de caracteres que você recuperou da CLI do Azure.This is 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.

Implantar o dispositivo do IoT EdgeDeploy the IoT Edge device

Esta seção usa um modelo do Azure Resource Manager para criar uma máquina virtual e instalar o runtime do IoT Edge nela.This section uses an Azure Resource Manager template to create a new virtual machine and install the IoT Edge runtime on it. Se você quiser usar seu dispositivo Linux, poderá seguir as etapas de instalação em Instalar o runtime do Azure IoT Edge e retornar a este início rápido.If you want to use your own Linux device instead, you can follow the installation steps in Install the Azure IoT Edge runtime, then return to this quickstart.

Use o comando da CLI a seguir para criar seu dispositivo do IoT Edge com base no modelo predefinido iotedge-vm-deploy.Use the following CLI command to create your IoT Edge device based on the prebuilt iotedge-vm-deploy template.

  • Para os usuários do Bash ou do Cloud Shell, copie o seguinte comando em um editor de texto, substitua o texto do espaço reservado pelas suas informações e copie-as na janela do Bash ou do Cloud Shell:For bash or Cloud Shell users, copy the following command into a text editor, replace the placeholder text with your information, then copy into your bash or Cloud Shell window:

    az deployment group create \
    --resource-group IoTEdgeResources \
    --template-uri "https://aka.ms/iotedge-vm-deploy" \
    --parameters dnsLabelPrefix='my-edge-vm' \
    --parameters adminUsername='azureUser' \
    --parameters deviceConnectionString=$(az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name
    <REPLACE_WITH_HUB_NAME> -o tsv) \
    --parameters authenticationType='password'
    --parameters adminPasswordOrKey="<REPLACE_WITH_PASSWORD>"
    
  • Para usuários do PowerShell, copie o seguinte comando para a janela do PowerShell e substitua o texto do espaço reservado pelas suas informações:For PowerShell users, copy the following command into your PowerShell window, then replace the placeholder text with your own information:

    az deployment group create `
    --resource-group IoTEdgeResources `
    --template-uri "https://aka.ms/iotedge-vm-deploy" `
    --parameters dnsLabelPrefix='my-edge-vm1' `
    --parameters adminUsername='azureUser' `
    --parameters deviceConnectionString=$(az iot hub device-identity connection-string show --device-id myEdgeDevice --hub-name <REPLACE_WITH_HUB_NAME> -o tsv) `
    --parameters authenticationType='password' `
    --parameters adminPasswordOrKey="<REPLACE_WITH_PASSWORD>"
    

Este modelo usa os seguintes parâmetros:This template takes the following parameters:

ParâmetroParameter DescriçãoDescription
resource-groupresource-group O grupo de recursos no qual os recursos serão criados.The resource group in which the resources will be created. Use o IoTEdgeResources padrão que usamos neste artigo ou forneça o nome de um grupo de recursos em sua assinatura.Use the default IoTEdgeResources that we've been using throughout this article or provide the name of an existing resource group in your subscription.
template-uritemplate-uri Um ponteiro para o modelo do Resource Manager que estamos usando.A pointer to the Resource Manager template that we're using.
dnsLabelPrefixdnsLabelPrefix Uma cadeia de caracteres que será usada para criar o nome de host da máquina virtual.A string that will be used to create the virtual machine's hostname. Use o exemplo my-edge-vm ou forneça uma nova cadeia de caracteres.Use the example my-edge-vm or provide a new string.
adminUsernameadminUsername Um nome de usuário para a conta do administrador da máquina virtual.A username for the admin account of the virtual machine. Use o exemplo azureUser ou fornecer um novo nome de usuário.Use the example azureUser or provide a new username.
deviceConnectionStringdeviceConnectionString A cadeia de conexão da identidade do dispositivo no Hub IoT, que é usada para configurar o runtime do IoT Edge na máquina virtual.The connection string from the device identity in IoT Hub, which is used to configure the IoT Edge runtime on the virtual machine. O comando da CLI dentro desse parâmetro captura a cadeia de conexão para você.The CLI command within this parameter grabs the connection string for you. Substitua o texto do espaço reservado pelo nome do hub IoT.Replace the placeholder text with your IoT hub name.
authenticationTypeauthenticationType O método de autenticação para a conta do administrador.The authentication method for the admin account. Este guia de início rápido usa autenticação por senha, mas você também pode definir esse parâmetro como sshPublicKey.This quickstart uses password authentication, but you can also set this parameter to sshPublicKey.
adminPasswordOrKeyadminPasswordOrKey A senha ou o valor da chave SSH para a conta do administrador.The password or value of the SSH key for the admin account. Substitua o texto do espaço reservado por uma senha segura.Replace the placeholder text with a secure password. Sua senha deve ter pelo menos 12 caracteres e ter três dos quatro seguintes itens: caracteres minúsculos, caracteres maiúsculos, dígitos e caracteres especiais.Your password must be at least 12 characters long and have three of four of the following: lowercase characters, uppercase characters, digits, and special characters.

Depois que a implantação for concluída, você deverá receber a saída formatada em JSON na CLI que contém as informações de SSH para se conectar à máquina virtual.Once the deployment is complete, you should receive JSON-formatted output in the CLI that contains the SSH information to connect to the virtual machine. Copie o valor da entrada SSH público da seção saídas:Copy the value of the public SSH entry of the outputs section:

Recuperar o valor de ssh público da saída

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

O restante dos comandos neste início rápido ocorrem em seu dispositivo IoT Edge propriamente dito, para que você possa ver o que está acontecendo no dispositivo.The rest of the commands in this quickstart take place on your IoT Edge device itself, so that you can see what's happening on the device. Se você estiver usando uma máquina virtual, conecte-se a esse computador agora usando o nome de usuário do administrador que você configurou e o nome DNS que foi apresentado pelo comando de implantação.If you're using a virtual machine, connect to that machine now using the admin username that you set up and the DNS name that was output by the deployment command. Também é possível encontrar o nome DNS em sua página de visão geral da máquina virtual no portal do Azure.You can also find the DNS name on your virtual machine's overview page in the Azure portal. Use o comando a seguir para se conectar à sua máquina virtual.Use the following command to connect to your virtual machine. Substitua {admin username} e {DNS name} pelos seus próprios valores.Replace {admin username} and {DNS name} with your own values.

ssh {admin username}@{DNS name}

Uma vez conectado à sua máquina virtual, verifique se o runtime foi instalado e configurado com êxito em seu dispositivo do IoT Edge.Once connected to your virtual machine, verify that the runtime was successfully installed and configured on your IoT Edge device.

  1. Verifique se o daemon de segurança do IoT Edge está em execução como um serviço do sistema.Check to see that the IoT Edge security daemon is running as a system service.

    sudo systemctl status iotedge
    

    Veja o daemon do IoT Edge em execução como um serviço do sistema

    Dica

    Você precisa de privilégios elevados para executar comandos iotedge.You need elevated privileges to run iotedge commands. Depois que você sair da sua máquina e fizer login novamente na primeira vez após instalar o runtime do IoT Edge, suas permissões serão atualizadas automaticamente.Once you sign out of your machine and sign back in the first time after installing the IoT Edge runtime, your permissions are automatically updated. Até lá, use sudo na frente dos comandos.Until then, use sudo in front of the commands.

  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.

    journalctl -u iotedge
    
  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.

    sudo 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 enviará dados telemétricos ao Hub IoT.Manage your Azure IoT Edge device from the cloud to deploy a module that will send 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.

Abra novamente o prompt de comando no seu dispositivo IoT Edge ou use a conexão SSH na CLI do Azure.Open the command prompt on your IoT Edge device again, or use the SSH connection from Azure CLI. 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:

sudo iotedge list

Exibir três módulos no seu dispositivo

Exiba as mensagens que estão sendo enviadas do módulo do sensor de temperatura:View the messages being sent from the temperature sensor module:

sudo 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.