Implantar módulos do Azure IoT Edge do portal do AzureDeploy Azure IoT Edge modules from the Azure portal

Após criar os módulos do IoT Edge com a lógica de negócios, você pretende implantá-los nos dispositivos para operar na borda.Once you create IoT Edge modules with your business logic, you want to deploy them to your devices to operate at the edge. Se houver vários módulos trabalhando em conjunto para coletar e processar dados, será possível implantá-los todos de uma vez e declarar as regras de roteamento que conecta-os.If you have multiple modules that work together to collect and process data, you can deploy them all at once and declare the routing rules that connect them.

Este artigo mostra como o portal do Azure guia você por meio da criação de um manifesto de implantação e de empurrar a implantação a um dispositivo IoT Edge.This article shows how the Azure portal guides you through creating a deployment manifest and pushing the deployment to an IoT Edge device. Para obter informações sobre como criar uma implantação que se destina a vários dispositivos com base em suas marcas compartilhadas, consulte implantar e monitorar módulos de IOT Edge em escala.For information about creating a deployment that targets multiple devices based on their shared tags, see Deploy and monitor IoT Edge modules at scale.

Pré-requisitosPrerequisites

Configurar um manifesto de implantaçãoConfigure a deployment manifest

Um manifesto de implantação é um documento JSON que descreve quais módulos implantar, como os dados fluem entre os módulos e as propriedades desejadas dos módulos gêmeos.A deployment manifest is a JSON document that describes which modules to deploy, how data flows between the modules, and desired properties of the module twins. Para obter mais informações sobre como os manifestos de implantação funcionam e como criá-los, consulte Entender como os módulos do IoT Edge podem ser utilizados, configurados e reutilizados.For more information about how deployment manifests work and how to create them, see Understand how IoT Edge modules can be used, configured, and reused.

O portal do Azure tem um assistente que ajuda você por meio da criação de manifesto de implantação, em vez de compilar manualmente o documento JSON.The Azure portal has a wizard that walks you through creating the deployment manifest, instead of building the JSON document manually. Ele tem três etapas: Adicionar módulos, Especificar rotas, e Rever implantação.It has three steps: Add modules, Specify routes, and Review deployment.

Observação

As etapas neste artigo refletem a versão de esquema mais recente do IoT Edge Agent e Hub.The steps in this article reflect the latest schema version of the IoT Edge agent and hub. A versão do esquema 1,1 foi lançada junto com IoT Edge versão 1.0.10 e habilita os recursos de ordem de inicialização do módulo e priorização de rota.Schema version 1.1 was released along with IoT Edge version 1.0.10, and enables the module startup order and route prioritization features.

Se você estiver implantando em um dispositivo que executa a versão 1.0.9 ou anterior, edite as configurações de tempo de execução na etapa módulos do assistente para usar a versão de esquema 1,0.If you are deploying to a device running version 1.0.9 or earlier, edit the Runtime Settings in the Modules step of the wizard to use schema version 1.0.

Selecionar dispositivo e adicionar módulosSelect device and add modules

  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 painel esquerdo, selecione IOT Edge no menu.On the left pane, select IoT Edge from the menu.

  3. Clique no ID do dispositivo alvo da lista de dispositivos.Click on the 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.

  5. Na seção configurações de registro de contêiner da página, forneça as credenciais para acessar qualquer registro de contêiner privado que contenha suas imagens de módulo.In the Container Registry Settings section of the page, provide the credentials to access any private container registries that contain your module images.

  6. Na seção módulos IOT Edge da página, selecione Adicionar.In the IoT Edge Modules section of the page, select Add.

  7. Escolha um dos três tipos de módulos no menu suspenso:Choose one of the three types of modules from the drop-down menu:

    • Módulo IOT Edge -você fornece o nome do módulo e o URI da imagem de contêiner.IoT Edge Module - You provide the module name and container image URI. Por exemplo, o URI da imagem para o módulo SimulatedTemperatureSensor de exemplo é mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.0 .For example, the image URI for the sample SimulatedTemperatureSensor module is mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.0. Se a imagem do módulo estiver armazenada em um registro de contêiner privado, adicione as credenciais nesta página para acessar a imagem.If the module image is stored in a private container registry, add the credentials on this page to access the image.
    • Módulo do Marketplace -módulos hospedados no Azure Marketplace.Marketplace Module - Modules hosted in the Azure Marketplace. Alguns módulos do Marketplace exigem configuração adicional, portanto, examine os detalhes do módulo na lista de módulos de IOT Edge do Azure Marketplace .Some marketplace modules require additional configuration, so review the module details in the Azure Marketplace IoT Edge Modules list.
    • Módulo Azure Stream Analytics -módulos gerados de uma carga de trabalho de Azure Stream Analytics.Azure Stream Analytics Module - Modules generated from an Azure Stream Analytics workload.
  8. Depois de adicionar um módulo, selecione o nome do módulo na lista para abrir as configurações do módulo.After adding a module, select the module name from the list to open the module settings. Preencha os campos opcionais se necessário.Fill out the optional fields if necessary.

    Para obter mais informações sobre as configurações de módulo disponíveis, consulte configuração e gerenciamento de módulo.For more information about the available module settings, see Module configuration and management.

    Para mais informações sobre o módulo gêmeo consulte Defina ou atualize propriedades desejadas.For more information about the module twin see Define or update desired properties.

  9. Repita as etapas de 6 a 8 para adicionar mais módulos à sua implantação.Repeat steps 6 through 8 to add additional modules to your deployment.

  10. Selecione Avançar: rotas para continuar na seção rotas.Select Next: Routes to continue to the routes section.

Especificar RotasSpecify routes

Na guia Rotas, defina como as mensagens são transmitidas entre os módulos e o Hub IoT.On the Routes tab, you define how messages are passed between modules and the IoT Hub. As mensagens são construídas com pares nome/valor.Messages are constructed using name/value pairs. Por padrão, a primeira implantação para um novo dispositivo inclui uma rota chamada rota e definida como de/messages/ * para $upstream, o que significa que qualquer saída de mensagens por qualquer módulo é enviada para o Hub IOT.By default, the first deployment for a new device includes a route called route and defined as FROM /messages/* INTO $upstream, which means that any messages output by any modules are sent to your IoT hub.

Os parâmetros Priority e time to Live são parâmetros opcionais que você pode incluir em uma definição de rota.The Priority and Time to live parameters are optional parameters that you can include in a route definition. O parâmetro Priority permite que você escolha quais rotas devem ter suas mensagens processadas primeiro ou quais rotas devem ser processadas por último.The priority parameter allows you to choose which routes should have their messages processed first, or which routes should be processed last. A prioridade é determinada pela definição de um número 0-9, em que 0 é a prioridade mais alta.Priority is determined by setting a number 0-9, where 0 is top priority. O parâmetro vida útil permite que você declare por quanto tempo as mensagens nessa rota devem ser mantidas até que sejam processadas ou removidas da fila.The time to live parameter allows you to declare how long messages in that route should be held until they're either processed or removed from the queue.

Para obter mais informações sobre como criar rotas, consulte declarar rotas.For more information about how to create routes, see Declare routes.

Depois que as rotas forem definidas, selecione Avançar: revisar + criar para continuar na próxima etapa do assistente.Once the routes are set, select Next: Review + create to continue to the next step of the wizard.

Rever implantaçãoReview deployment

A seção de revisão mostra o manifesto de implantação JSON que foi criado baseado nas suas seleções nas duas seções anteriores.The review section shows you the JSON deployment manifest that was created based on your selections in the previous two sections. Note que há dois módulos declarados que você não adicionou: $edgeAgent e $edgeHub.Note that there are two modules declared that you didn't add: $edgeAgent and $edgeHub. Estes dois módulos enganam o runtime do IoT Edge e são padrões requeridos em toda implantação.These two modules make up the IoT Edge runtime and are required defaults in every deployment.

Examine as informações de implantação e, em seguida, selecione criar.Review your deployment information, then select Create.

Exibir módulos no dispositivoView modules on your device

Depois de implantar módulos no seu dispositivo, você pode exibir todos eles na página de detalhes do dispositivo do Hub IoT.Once you've deployed modules to your device, you can view all of them in the device details page of your IoT Hub. Esta página mostra o nome de cada módulo implantado, como também informações úteis como o status de implantação e o código de saída.This page displays the name of each deployed module, as well as useful information like the deployment status and exit code.

Implantar módulos do Azure MarketplaceDeploy modules from Azure Marketplace

O Azure Marketplace é um Marketplace de aplicativos e serviços online, no qual você pode navegar por uma ampla variedade de aplicativos e soluções empresariais que são certificados e otimizados para serem executados no Azure, incluindo módulos IOT Edge.Azure Marketplace is an online applications and services marketplace where you can browse through a wide range of enterprise applications and solutions that are certified and optimized to run on Azure, including IoT Edge modules.

Você pode implantar um módulo IoT Edge do Azure Marketplace e de seu hub IoT.You can deploy an IoT Edge module from the Azure Marketplace and from your IoT Hub.

Implantar do Azure MarketplaceDeploy from Azure Marketplace

Examinar os módulos de IoT Edge no Marketplace e quando você encontrar o que você deseja implantar, selecionando criar ou obtê-lo agora.Peruse the IoT Edge modules in the marketplace and when you find the one you want you can deploy it by selecting Create or Get it now. Prossiga com as etapas do assistente de implantação que podem variar dependendo do módulo de IoT Edge selecionado:Proceed with the deployment wizard steps which may vary depending on the IoT Edge module you selected:

  1. Confirme os termos de uso e a política de privacidade do provedor selecionando Continuar.Acknowledge the provider's terms of use and privacy policy by selecting Continue. Você pode primeiro precisar fornecer informações de contato.You may first have to provide contact information.
  2. Escolha sua assinatura e o Hub IoT ao qual o dispositivo de destino está anexado.Choose your subscription and the IoT Hub to which the target device is attached.
  3. Selecione Implantar em um dispositivo.Choose Deploy to a device.
  4. Insira o nome do dispositivo ou selecione Localizar dispositivo para navegar entre os dispositivos registrados com o hub.Enter the name of the device or select Find Device to browse among the devices registered with the hub.
  5. Selecione Criar para continuar o processo padrão de configuração de um manifesto de implantação, incluindo a adição de outros módulos se desejado.Select Create to continue the standard process of configuring a deployment manifest, including adding other modules if desired. Os detalhes para o novo módulo são predefinidos, como a imagem do URI, as opções de criação e as propriedades desejadas, mas podem ser alterados.Details for the new module such as image URI, create options, and desired properties are predefined but can be changed.

Verifique se o módulo está implantado em seu hub IoT no portal do Azure.Verify that the module is deployed in your IoT Hub in the Azure portal. Selecione seu dispositivo, selecione definir módulos e o módulo deve estar listado na seção módulos de IOT Edge .Select your device, select Set Modules and the module should be listed in the IoT Edge Modules section.

Implantar do Hub IoT do AzureDeploy from Azure IoT Hub

Você pode implantar rapidamente um módulo do Azure Marketplace em seu dispositivo no Hub IoT no portal do Azure.You can quickly deploy a module from the Azure Marketplace onto your device in your IoT Hub in the Azure portal.

  1. No portal do Azure, navegue até o Hub IoT.In the Azure portal, navigate to your IoT Hub.
  2. No painel esquerdo, em Gerenciamento de dispositivo automático, selecione IOT Edge.On the left pane, under Automatic Device Management, select IoT Edge.
  3. Selecione o dispositivo IoT Edge que deve receber a implantação.Select the IoT Edge device that is to receive the deployment.
  4. Na barra superior, selecione Definir Módulos.On the upper bar, select Set Modules.
  5. Na seção módulos IOT Edge , clique em Adicionare selecione módulo do Marketplace no menu suspenso.In the IoT Edge Modules section, click Add, and select Marketplace Module from the drop-down menu.

Adicionar módulo no Hub IoT

Escolha um módulo na página IOT Edge do Marketplace do módulo .Choose a module from the IoT Edge Module Marketplace page. O módulo selecionado é configurado automaticamente para sua assinatura, grupo de recursos e dispositivo.The module you select is automatically configured for your subscription, resource group, and device. Em seguida, ele aparece na lista de módulos de IoT Edge.It then appears in your list of IoT Edge modules. Alguns módulos podem exigir configuração adicional.Some modules may require additional configuration.

Dica

As informações sobre os módulos de IoT Edge do Hub IoT do Azure são limitadas.The information about IoT Edge modules from the Azure IoT Hub is limited. Primeiro, você pode aprender mais sobre os módulos de IOT Edge no Azure Marketplace.You can first learn more about the IoT Edge modules in the Azure Marketplace.

Selecione Avançar: rotas e continuar com a implantação conforme descrito por especificar rotas e examinar a implantação anteriormente neste artigo.Select Next: Routes and continue with deployment as described by Specify routes and Review Deployment earlier in this article.

Próximas etapasNext steps

Saiba como Implantar e monitorar módulos do IoT Edge em escalaLearn how to Deploy and monitor IoT Edge modules at scale