Crie e provisione o IoT Edge para Linux em dispositivos Windows em escala usando chaves simétricas

Se você quiser usar o PowerShell, use as seguintes etapas para preparar seu dispositivo de destino para a instalação do Azure IoT Edge para Linux no Windows e a implantação da máquina virtual Linux:

1. Defina a política de execução no dispositivo de destino como AllSigned. Você pode verificar a política de execução atual em um prompt do PowerShell com privilégios elevados usando o seguinte comando:

   Get-ExecutionPolicy -List
   

   Se a política de execução de local machine não for AllSigned, poderá definir a política de execução usando:

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

Para obter mais informações sobre o módulo Azure IoT Edge para Linux no Windows PowerShell, consulte a referência de funções do PowerShell.

Se você quiser usar o Windows Admin Center, use as seguintes etapas para baixar e instalar o Windows Admin Center e instalar a extensão Windows Admin Center Azure IoT Edge:

1. Descarregue e execute o instalador do Windows Admin Center. Siga as instruções do assistente de instalação para instalar o Windows Admin Center.

2. Uma vez instalado, use um navegador compatível para abrir o Windows Admin Center. Os navegadores suportados incluem o Microsoft Edge (Windows 10, versão 1709 ou posterior), o Google Chrome e o Microsoft Edge Insider.

3. Na primeira utilização do Windows Admin Center, ser-lhe-á pedido para selecionar um certificado a utilizar. Selecione Cliente do Windows Admin Center como seu certificado.

4. Instale a extensão Azure IoT Edge. Selecione o ícone de engrenagem no canto superior direito do painel do Windows Admin Center.

   Selecione o ícone de engrenagem no canto superior direito do painel de controlo para aceder às configurações.

5. No menu Configurações , em Gateway, selecione Extensões.

6. Na guia Extensões disponíveis , localize Azure IoT Edge na lista de extensões. Escolha e selecione a opção Instalar acima da lista de extensões.

7. Após a conclusão da instalação, você verá o Azure IoT Edge na lista de extensões instaladas na guia Extensões instaladas .

Fazer uma inscrição individual no DPS

1. No portal do Azure, navegue até a sua instância do serviço de provisionamento de dispositivos do Hub IoT.

2. Em Configurações, selecione Gerenciar inscrições.

3. Selecione Adicionar inscrição individual e conclua as seguintes etapas para configurar o registro:

   1. Em Mecanismo, selecione Chave simétrica.

   2. Forneça um ID de registo exclusivo para o seu dispositivo.

   3. Forneça, se desejar, um ID de dispositivo do Hub IoT para o seu equipamento. Você pode usar IDs de dispositivo para direcionar um dispositivo individual para implantação de módulo. Se você não fornecer um ID de dispositivo, o ID de registro será usado.

   4. Selecione True para declarar que o registro é para um dispositivo IoT Edge.

   5. Opcionalmente, adicione um valor de tag ao estado gêmeo inicial do dispositivo. Você pode usar tags para segmentar grupos de dispositivos para implantação de módulos. Por exemplo:

      {
         "tags": {
            "environment": "test"
         },
         "properties": {
            "desired": {}
         }
      }
      

   6. Selecione Salvar.

4. Copie o valor da Chave Primária do registo individual para utilizar ao instalar o ambiente de execução do IoT Edge.

Agora que existe uma inscrição para este dispositivo, o runtime do IoT Edge pode provisionar automaticamente o dispositivo durante a instalação.

Criar um registro de grupo DPS

1. No portal do Azure, navegue até a sua instância do serviço de provisionamento de dispositivos do Hub IoT.

2. Em Configurações, selecione Gerenciar inscrições.

3. Selecione Adicionar inscrição individual e conclua as seguintes etapas para configurar o registro:

   1. Forneça um nome de grupo.

   2. Selecione Chave simétrica como o tipo de atestado.

   3. Selecione True para declarar que o registro é para um dispositivo IoT Edge. Para uma inscrição de grupo, todos os dispositivos devem ser dispositivos IoT Edge ou nenhum deles poderá ser.

   4. Opcionalmente, adicione um valor de tag ao estado gêmeo inicial do dispositivo. Você pode usar tags para segmentar grupos de dispositivos para implantação de módulos. Por exemplo:

      {
         "tags": {
            "environment": "test"
         },
         "properties": {
            "desired": {}
         }
      }
      

   5. Selecione Salvar.

4. Copie o valor da Chave Primária do seu grupo de inscrição para usar ao criar chaves de dispositivo para uso com um registro de grupo.

Agora que existe um grupo de inscrição, o runtime do IoT Edge pode provisionar dispositivos automaticamente durante a instalação.

Derivar uma chave de dispositivo

Cada dispositivo provisionado como parte de uma inscrição em grupo precisa de uma chave de dispositivo derivada para realizar a prova de chave simétrica durante o provisionamento.

Para gerar uma chave de dispositivo, use a chave que você copiou do seu grupo de registro DPS para calcular um HMAC-SHA256 do ID de registro exclusivo para o dispositivo e converter o resultado no formato Base64.

No Windows, você pode usar o PowerShell para gerar sua chave de dispositivo derivada, conforme mostrado no exemplo a seguir.

Substitua o valor de KEY pela Chave Primária que você anotou anteriormente.

Substitua o valor de REG_ID pelo ID de registo do dispositivo.

$KEY='PASTE_YOUR_ENROLLMENT_KEY_HERE'
$REG_ID='PASTE_YOUR_REGISTRATION_ID_HERE'

$hmacsha256 = New-Object System.Security.Cryptography.HMACSHA256
$hmacsha256.key = [Convert]::FromBase64String($KEY)
$sig = $hmacsha256.ComputeHash([Text.Encoding]::ASCII.GetBytes($REG_ID))
$derivedkey = [Convert]::ToBase64String($sig)
echo "`n$derivedkey`n"

Abaixo está uma saída de exemplo de uma chave de dispositivo derivada:

Jsm0lyGpjaVYVP2g3FnmnmG9dI/9qU24wNoykUmermc=

Instale o IoT Edge para Linux no Windows no seu dispositivo de destino.

1. Em uma sessão do PowerShell com privilégios elevados, execute cada um dos comandos a seguir para baixar o IoT Edge para Linux no Windows.

   $msiPath = $([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))
   $ProgressPreference = 'SilentlyContinue'
   Invoke-WebRequest "https://aka.ms/AzEflowMSI" -OutFile $msiPath
   

2. Instale o IoT Edge para Linux no Windows no seu dispositivo.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn"
   

   Você pode especificar diretórios personalizados de instalação do IoT Edge para Linux no Windows e VHDX ao adicionar os parâmetros INSTALLDIR="<FULLY_QUALIFIED_PATH>" e VHDXDIR="<FULLY_QUALIFIED_PATH>" ao comando install. Por exemplo, se você quiser usar a pasta D:\EFLOW para instalação e D :\EFLOW-VHDX para o VHDX, poderá usar o seguinte cmdlet do PowerShell.

   Start-Process -Wait msiexec -ArgumentList "/i","$([io.Path]::Combine($env:TEMP, 'AzureIoTEdge.msi'))","/qn","INSTALLDIR=D:\EFLOW", "VHDXDIR=D:\EFLOW-VHDX"
   

3. Defina a política de execução no dispositivo de destino como AllSigned se ainda não estiver. Consulte os pré-requisitos do PowerShell para comandos para verificar a política de execução atual e definir a política de execução como AllSigned.

4. Crie a implantação do IoT Edge para Linux no Windows. A implantação cria a sua máquina virtual Linux e instala o runtime do IoT Edge para si.

   Deploy-Eflow
   

   Sugestão

   Por padrão, o Deploy-Eflow comando cria sua máquina virtual Linux com 1 GB de RAM, 1 núcleo vCPU e 16 GB de espaço em disco. No entanto, os recursos de que sua VM precisa dependem muito das cargas de trabalho implantadas. Se sua VM não tiver memória suficiente para suportar suas cargas de trabalho, ela não será iniciada.

   Você pode personalizar os recursos disponíveis da máquina virtual usando os Deploy-Eflow parâmetros opcionais do comando.

   Por exemplo, o comando abaixo cria uma máquina virtual com 4 núcleos vCPU, 4 GB de RAM (representados em MB) e 20 GB de espaço em disco:

   Deploy-Eflow -cpuCount 4 -memoryInMB 4096 -vmDiskSize 20
   

   Para obter informações sobre todos os parâmetros opcionais disponíveis, consulte Funções do PowerShell para IoT Edge para Linux no Windows.

   Advertência

   Por padrão, a máquina virtual EFLOW Linux não tem configuração de DNS. As implantações usando DHCP tentarão obter a configuração DNS propagada pelo servidor DHCP. Verifique a configuração do DNS para garantir a conectividade com a Internet. Para obter mais informações, consulte AzEFLOW-DNS.

   Você pode atribuir uma GPU à sua implantação para habilitar módulos Linux acelerados por GPU. Para obter acesso a esses recursos, você precisará instalar os pré-requisitos detalhados em Aceleração de GPU para o Azure IoT Edge para Linux no Windows.

   Para usar uma passagem de GPU, adicione os parâmetros gpuName, gpuPassthroughType e gpuCount ao comando Deploy-Eflow . Para obter informações sobre todos os parâmetros opcionais disponíveis, consulte Funções do PowerShell para IoT Edge para Linux no Windows.

   Advertência

   Habilitar a passagem de dispositivo de hardware pode aumentar os riscos de segurança. A Microsoft recomenda um driver de mitigação de dispositivo do fornecedor da GPU, quando aplicável. Para obter mais informações, consulte Implantar dispositivos gráficos usando atribuição de dispositivo discreto.

5. Digite 'Y' para aceitar os termos da licença.

6. Digite 'O' ou 'R' para ativar ou desativar os dados de diagnóstico opcionais , dependendo da sua preferência.

7. Quando a implantação estiver concluída, a janela do PowerShell relatará a implantação bem-sucedida.

   

   Após uma implantação bem-sucedida, você estará pronto para provisionar seu dispositivo.

1. Instale e abra o Windows Admin Center.

   Na página inicial do Windows Admin Center, na lista de conexões, você verá uma conexão de host local representando o computador onde você está executando o Windows Admin Center. Quaisquer servidores, PCs ou clusters adicionais que você gerencia também aparecerão aqui.

   Você pode usar o Windows Admin Center para gerenciar o Azure IoT Edge para Linux no Windows em seu dispositivo local ou em dispositivos gerenciados remotamente. Neste guia, a conexão de host local servirá como o dispositivo de destino para a implantação do Azure IoT Edge para Linux no Windows.

2. Confirme se o seu dispositivo local está listado em Todas as ligações, como mostrado abaixo.

   

   Se pretender implementar num dispositivo de destino remoto em vez do dispositivo local e não vir o dispositivo de destino pretendido na lista, siga as instruções para adicionar o dispositivo.

3. Selecione + Adicionar para começar a criar sua implantação. A implantação cria a sua máquina virtual Linux e instala o runtime do IoT Edge para si.

4. No painel Adicionar ou criar recursos , localize o bloco Azure IoT Edge . Selecione Criar novo para instalar uma nova instância do Azure IoT Edge para Linux no Windows em um dispositivo.

   Se você já tiver o IoT Edge para Linux no Windows em execução em um dispositivo, poderá selecionar Adicionar para se conectar a esse dispositivo IoT Edge existente e gerenciá-lo com o Windows Admin Center.

   Selecione "Criar Novo" no bloco do Azure IoT Edge no Windows Admin Center, PNG.

5. O painel "Criar uma implementação do Azure IoT Edge para Linux no Windows" será aberto. No 1. Introdução, reveja os requisitos mínimos e selecione Avançar.

6. Reveja os termos da licença, marque Aceito e selecione Seguinte.

7. Você pode ativar ou desativar os dados de diagnóstico opcionais , dependendo da sua preferência.

8. Selecione Next: Deploy.

   

9. No separador 2. Implantar, em Selecione o dispositivo de destino, clique no dispositivo listado para confirmar que cumpre os requisitos mínimos. Quando o seu estado for confirmado como suportado, selecione Seguinte.

   

10. Na guia Configurações 2.2 , revise as definições de configuração de sua implantação. A tabela abaixo mostra as configurações e seus valores padrão.

    Configurações	Valor predefinido
    Tamanho do disco virtual em GB	16
    Memória em MB (número par)	1024
    Número de núcleos	2
    Versão do Azure IoT Edge	1.1 (LTS)

    Observação

    O IoT Edge para Linux no Windows usa um switch padrão, que atribui à máquina virtual Linux um endereço IP interno. Este endereço IP interno não pode ser alcançado de fora da máquina Windows. Você pode se conectar à máquina virtual localmente enquanto estiver conectado à máquina Windows.

    Se estiver a usar o Windows Server, configure um switch por defeito antes de implantar o IoT Edge para Linux no Windows Server.

    Você pode atribuir uma GPU à sua implantação para habilitar módulos Linux acelerados por GPU. Para obter acesso a esses recursos, você precisará instalar os pré-requisitos detalhados em Aceleração de GPU para o Azure IoT Edge para Linux no Windows. Se você estiver instalando apenas esses pré-requisitos neste ponto do processo de implantação, precisará começar novamente desde o início.

    Há duas opções de passagem de GPU disponíveis: Direct Device Assignment (DDA) e GPU Paravirtualization (GPU-PV), dependendo do adaptador de GPU atribuído à sua implantação.

    Para o método de atribuição direta de dispositivos, selecione o número de processadores GPU a serem alocados para sua máquina virtual Linux.

    Para o método de paravirtualização, nenhuma configuração adicional é necessária.

    Advertência

    Habilitar a passagem de dispositivo de hardware pode aumentar os riscos de segurança. A Microsoft recomenda um driver de mitigação de dispositivo do fornecedor da GPU, quando aplicável. Para obter mais informações, consulte Implantar dispositivos gráficos usando atribuição de dispositivo discreto.

    Quando estiver satisfeito com as configurações, selecione Avançar.

11. No separador "Implementação 2.3", pode-se acompanhar o progresso da implementação. O processo completo inclui baixar o pacote do Azure IoT Edge para Linux no Windows, instalar o pacote, configurar o dispositivo host e configurar a máquina virtual Linux. Este processo pode levar vários minutos para ser concluído. Uma implantação bem-sucedida é mostrada abaixo.

    

12. Quando a implantação estiver concluída, você estará pronto para provisionar seu dispositivo. Selecione Seguinte: Conectar para prosseguir para o separador 3. Conectar, que lida com o provisionamento de dispositivos do Azure IoT Edge.

Para o PowerShell, execute o seguinte comando com os valores de espaço reservado atualizados com seus próprios valores:

Provision-EflowVm -provisioningType DpsSymmetricKey -​scopeId PASTE_YOUR_ID_SCOPE_HERE -registrationId PASTE_YOUR_REGISTRATION_ID_HERE -symmKey PASTE_YOUR_PRIMARY_KEY_OR_DERIVED_KEY_HERE

Para o Windows Admin Center, use as seguintes etapas:

1. No painel de provisionamento de dispositivo do Azure IoT Edge , selecione Chave Simétrica (DPS) na lista suspensa do método de provisionamento.

2. No portal do Azure, navegue até sua instância do DPS.

3. Forneça sua ID de escopo do DPS, ID de registro do dispositivo e chave primária de registro ou chave derivada nos campos do Windows Admin Center.

4. Escolha Provisionamento com o método selecionado.

   Escolha o método de provisionamento selecionado após preencher os campos obrigatórios para provisionamento de chave simétrica em PNG.

5. Quando o provisionamento estiver concluído, selecione Concluir. Você será levado de volta ao painel principal. Agora, deves ver um novo dispositivo listado, cujo tipo é IoT Edge Devices. Você pode selecionar o dispositivo IoT Edge para se conectar a ele. Uma vez na página Visão geral , você pode visualizar a Lista de módulos do IoT Edge e o Status do IoT Edge do seu dispositivo.

Você pode verificar se o registro individual criado no serviço de provisionamento de dispositivo foi usado. Navegue até a instância do serviço de provisionamento de dispositivo no portal do Azure. Abra os detalhes da inscrição individual que você criou. Observe que o estado da inscrição é atribuído e o ID do dispositivo está listado.

Você pode verificar se o registro de grupo criado no serviço de provisionamento de dispositivo foi usado. Navegue até a instância do serviço de provisionamento de dispositivo no portal do Azure. Abra os detalhes da inscrição para o grupo que você criou. Aceda ao separador Registos de Registo para ver todos os dispositivos registados nesse grupo.

1. Faça login na máquina virtual do IoT Edge para Linux no Windows usando o seguinte comando na sessão do PowerShell:

   Connect-EflowVm
   

   Observação

   A única conta permitida para SSH para a máquina virtual é o usuário que a criou.

2. Depois de fazer login, você pode verificar a lista de módulos do IoT Edge em execução usando o seguinte comando do Linux:

   sudo iotedge list
   

3. Se você precisar solucionar problemas do serviço IoT Edge, use os seguintes comandos do Linux.

   1. Recupere os logs de serviço.

      sudo journalctl -u iotedge
      

   2. Use a check ferramenta para verificar o estado da configuração e da conexão do dispositivo.

      sudo iotedge check
      

   Observação

   Em um dispositivo recém-provisionado, você pode ver um erro relacionado ao IoT Edge Hub:

   × preparação para produção: o diretório de armazenamento do Edge Hub é persistido no sistema de arquivos do host - Erro

   Não foi possível verificar o estado atual do contêiner edgeHub

   Esse erro é esperado em um dispositivo recém-provisionado porque o módulo IoT Edge Hub não está em execução. Para resolver o erro, no Hub IoT, defina os módulos para o dispositivo e crie uma implantação. A criação de uma implantação para o dispositivo inicia os módulos no dispositivo, incluindo o módulo IoT Edge Hub.

1. Selecione seu dispositivo IoT Edge na lista de dispositivos conectados no Windows Admin Center para se conectar a ele.

2. A página de visão geral do dispositivo exibe algumas informações sobre o dispositivo:

   • A seção Lista de Módulos do IoT Edge mostra os módulos em execução no dispositivo. Quando o serviço IoT Edge for iniciado pela primeira vez, deverá ver apenas o módulo edgeAgent em execução. O módulo edgeAgent é executado por padrão e ajuda a instalar e iniciar quaisquer módulos adicionais que você implantar em seu dispositivo.

   • A seção Estado da Borda IoT mostra o estado do serviço e deve relatar ativo (em execução).