Criar e provisionar IoT Edge para Linux em dispositivos Windows em escala usando certificados X.509

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 do local machine não for AllSigned, você poderá definir a política de execução usando:

   Set-ExecutionPolicy -ExecutionPolicy AllSigned -Force
   

Para obter mais informações sobre o módulo do PowerShell do Azure IoT Edge para Linux no Windows, confira 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 do Windows Azure IoT Edge do Windows Admin Center:

1. Baixe e execute o instalador do Windows Admin Center . Siga os prompts do assistente de instalação para instalar o Windows Admin Center.

2. Depois de instalado, use um navegador com suporte para abrir o Windows Admin Center. Os navegadores com suporte incluem o Microsoft Edge (Windows 10, versão 1709 ou posterior), Google Chrome e Microsoft Edge Insider.

3. No primeiro uso do Windows Admin Center, você será solicitado a selecionar um certificado a ser usado. Selecione cliente do Windows Admin Center como seu certificado.

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

   

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

6. Na guia Extensões disponíveis, encontre Azure IoT Edge na lista de extensões. Escolha-o e selecione o prompt Instalar acima da lista de extensões.

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

Criar um registro individual de DPS

As inscrições individuais utilizam a seção pública do certificado de identidade de um dispositivo e a comparam com o certificado no dispositivo.

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

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

3. Selecione adicionar registro individual, em seguida, conclua as seguintes etapas para configurar o registro:

   • Mecanismo: selecione X.509.

   • Arquivo .pem ou .cer do certificado primário: carregue o arquivo público do certificado de identidade do dispositivo. Se você usou os scripts para gerar um certificado de teste, escolha o seguinte arquivo:

     <WRKDIR>\certs\iot-edge-device-identity-<name>.cert.pem

   • ID de Dispositivo do Hub IoT: forneça uma ID para o seu dispositivo, se desejar. Você pode usar IDs de dispositivo para direcionar um dispositivo individual na implantação de módulos. Se você não fornecer uma ID de dispositivo, o CN (nome comum) no certificado X.509 será usado.

   • Dispositivo do IoT Edge: selecione True para declarar que o registro é para um dispositivo do IoT Edge.

   • Selecione os hubs IoT aos quais este dispositivo pode ser atribuído: escolha o Hub IoT vinculado ao qual você deseja conectar o dispositivo. Você pode escolher vários hubs e o dispositivo será atribuído a um deles de acordo com a política de alocação selecionada.

   • Estado inicial do dispositivo gêmeo: adicione um valor de etiqueta ao dispositivo gêmeo, se desejar. Você pode usar tags para direcionar grupos de dispositivos para a implantação automática. Por exemplo:

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

4. Clique em Salvar.

Em Gerenciar Registros, você pode ver a ID do Registro que acabou de criar. Anote-a, pois ela pode ser usada quando você provisiona seu dispositivo.

Agora que existe um registro para esse dispositivo, o runtime do IoT Edge pode provisionar automaticamente o dispositivo durante a instalação.

Criar um registro de grupo de DPS

Os registros de grupo usam um certificado de AC raiz ou intermediária da cadeia de certificados de confiança usada para gerar os certificados de identidade do dispositivo individual.

Verificar seu certificado raiz

Ao criar um grupo de registro, você tem a opção de usar um certificado verificado. Você pode verificar um certificado com o DPS comprovando que tem a propriedade do certificado raiz. Para obter mais informações, consulte Como realizar uma prova de posse para certificados de autoridade de certificação X.509.

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

2. Selecione Certificados no menu da esquerda.

3. Selecione Adicionar para adicionar um novo certificado.

4. Insira um nome amigável para seu certificado e, em seguida, navegue até o arquivo .cer ou .pem que representa a parte pública do seu certificado X.509.

   Se você estiver usando os certificados de demonstração, carregue o certificado <wrkdir>\certs\azure-iot-test-only.root.ca.cert.pem.

5. Clique em Salvar.

6. O certificado agora deve estar listado na página Certificados. Selecione-o para abrir os detalhes do certificado.

7. Selecione Gerar Código de Verificação e, em seguida, copie o código gerado.

8. Se você trouxer seu próprio certificado de autoridade de certificação ou estiver usando os certificados de demonstração, poderá usar a ferramenta de verificação fornecida no repositório IoT Edge para verificar a prova de posse. A ferramenta de verificação usa seu certificado de autoridade de certificação para assinar um novo certificado que tem o código de verificação fornecido como o nome do sujeito.

   New-CACertsVerificationCert "<verification code>"
   

9. Na mesma página de detalhes do certificado no portal do Azure, carregue o certificado de verificação gerado recentemente.

10. Selecione Verificar.

Criar o grupo de registro

Para saber mais sobre registros no serviço de provisionamento de dispositivos, confira Como gerenciar registros de dispositivo.

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

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

3. Selecione Adicionar grupo de registro, em seguida, conclua as seguintes etapas para configurar o registro:

   • Nome do grupo: forneça um nome fácil de memorizar para este registro de grupo.

   • Tipo de atestado: selecione Certificado.

   • Dispositivo do IoT Edge: selecione True. Para um registro de grupo, todos os dispositivos devem ser dispositivos do IoT Edge ou nenhum deles pode ser.

   • Tipo de Certificado: selecione Certificado de Autoridade de Certificação.

   • Certificado primário: escolha o seu certificado na lista suspensa.

   • Selecione os hubs IoT aos quais este dispositivo pode ser atribuído: escolha o Hub IoT vinculado ao qual você deseja conectar o dispositivo. Você pode escolher vários hubs e o dispositivo será atribuído a um deles de acordo com a política de alocação selecionada.

   • Estado inicial do dispositivo gêmeo: adicione um valor de etiqueta ao dispositivo gêmeo, se desejar. Você pode usar tags para direcionar grupos de dispositivos para a implantação automática. Por exemplo:

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

4. Clique em Salvar.

Em Gerenciar Registros, você pode ver a ID do Registro que acabou de criar. Anote-a, pois ela pode ser usada quando você provisiona seu dispositivo.

Agora que existe um registro desses dispositivos, o runtime do IoT Edge pode provisionar automaticamente os dispositivos durante a instalação.

Instale o IoT Edge para Linux no Windows em 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 em 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 no Linux e no Windows e do VHDX adicionando os parâmetros INSTALLDIR="<FULLY_QUALIFIED_PATH>" e VHDXDIR="<FULLY_QUALIFIED_PATH>" ao comando de instalação. Por exemplo, se você quiser usar a pasta D:\EFLOW para instalação e a pasta 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 definida. Confira 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 em Windows. A implantação cria sua máquina virtual do Linux e instala o runtime do IoT Edge para você.

   Deploy-Eflow
   

   Dica

   Por padrão, o comando Deploy-Eflow cria a 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 a VM não tiver memória suficiente para dar suporte às cargas de trabalho, ela não será iniciada.

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

   Por exemplo, o comando a seguir cria uma máquina virtual com 4 núcleos de vCPU, 4 GB de RAM (representado 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, confira Funções do PowerShell para o IoT Edge para Linux no Windows.

   Aviso

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

   Você pode atribuir uma GPU à implantação para habilitar os módulos do Linux acelerados por GPU. Para obter acesso a esses recursos, você precisará instalar os pré-requisitos detalhados em aceleração de GPU do 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, confira Funções do PowerShell para o IoT Edge para Linux no Windows.

   Aviso

   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, confira Implantar dispositivos gráficos usando a atribuição discreta de dispositivo.

5. Insira "Y" para aceitar os termos de licença.

6. Insira "O" ou "R" para ativar ou desativar Dados de diagnóstico opcionais, dependendo de sua preferência.

7. Depois que a implantação for concluída, a janela do PowerShell relatará Implantação bem-sucedida.

   

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

1. Instalar e abrir 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 em que você está executando o Windows Admin Center. Todos os servidores, computadores ou clusters adicionais gerenciados 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 dispositivos gerenciados remotos. 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 dispositivo local está listado em Todas as conexões, como mostrado a seguir.

   

   Se você quiser implantar em um dispositivo remoto de destino em vez de seu dispositivo local e o dispositivo de destino desejado não estiver visível 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 sua máquina virtual do Linux e instala o runtime do IoT Edge para você.

4. No painel Adicionar ou criar recursos, localize o bloco do Azure IoT Edge. Selecione Criar nova 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.

   

5. O painel Criar um Azure IoT Edge para Linux no Windows será aberto. Na 1. Aba Introdução, examine os requisitos mínimos e selecione Próximo (Next).

6. Examine os termos de licença, verifique Aceitoe selecione Próximo.

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

8. Selecione Avançar: Implantar.

   

9. Na aba 2. Implante, no Selecione o dispositivo de destino, clique no dispositivo listado para validar que ele atende aos requisitos mínimos. Depois que seu status for confirmado como suportado, selecione Próximo.

   

10. Na guia Configurações do 2.2, examine as configurações da sua implantação. A tabela a seguir mostra as configurações e seus valores padrão.

    Configurações	Valor padrão
    Tamanho do disco virtual em GB	16
    MB em memória (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 comutador padrão, que atribui à máquina virtual linux um endereço IP interno. Esse endereço IP interno não pode ser acessado de fora do computador Windows. Você pode se conectar à máquina virtual localmente enquanto estiver conectado ao computador Windows.

    Se você estiver usando o Windows Server, configure um comutador padrão antes de implantar o IoT Edge para Linux no Windows.

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

    Há duas opções de passagem de GPU disponíveis: Atribuição Direta de Dispositivo (DDA) e Paravirtualização de GPU (GPU-PV), dependendo do adaptador de GPU que você atribuir à sua implantação.

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

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

    Aviso

    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, confira Implantar dispositivos gráficos usando a atribuição discreta de dispositivo.

    Depois de estar satisfeito com as configurações, selecione Próximo.

11. Na aba de Implantação do 2.3, você pode observar o progresso da implantaçã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. Esse processo pode levar vários minutos para ser concluído. Uma implantação bem-sucedida está exibida abaixo.

    

12. Depois que sua implantação for concluída, você estará pronto para provisionar seu dispositivo. Selecione . Em seguida: Conecte para prosseguir para a guia 3. Conectar, que gerencia 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 DpsX509 -scopeId PASTE_YOUR_ID_SCOPE_HERE -registrationId PASTE_YOUR_REGISTRATION_ID_HERE -identityCertPath PASTE_ABSOLUTE_PATH_TO_IDENTITY_CERTIFICATE_HERE -identityPrivKeyPath PASTE_ABSOLUTE_PATH_TO_IDENTITY_PRIVATE_KEY_HERE

Para o Windows Admin Center, use as seguintes etapas:

1. No painel de provisionamento de dispositivos do Azure IoT Edge, selecione Certificado X509 (DPS) no menu suspenso do método de provisionamento.

2. Forneça sua ID de escopo DPS, ID de registro do dispositivo e chave primária de registro ou chave derivada nos campos do Centro de Administração do Windows.

3. Escolha provisionamento com o método selecionado.

   

4. Depois que o provisionamento estiver concluído, selecione Concluir. Você será levado de volta ao painel principal. Agora, você deve 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 de 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 dispositivos foi usado. Navegue até a sua instância do serviço de provisionamento de dispositivos do portal do Azure. Abra os detalhes da matrícula para a matrícula individual que você criou. Observe que o status da inscrição é atribuído e o ID do dispositivo está listado.

Verifique se o registro de grupo criado no serviço de provisionamento de dispositivos foi usado. Navegue até a sua instância do serviço de provisionamento de dispositivos do portal do Azure. Abra os detalhes da inscrição para a inscrição de grupo que você criou. Vá para a guia Registros para exibir todos os dispositivos registrados nesse grupo.

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

   Connect-EflowVm
   

   Observação

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

2. Depois de fazer logon, você poderá 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 de serviço do IoT Edge, use os comandos do Linux a seguir.

   1. Se você precisar solucionar problemas do serviço, recupere os logs de serviço.

      sudo journalctl -u iotedge
      

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

      sudo iotedge check
      

   Observação

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

   × preparação para produção: o diretório de armazenamento do Hub do Edge está 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, pois o módulo do Hub do IoT Edge 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 módulos em execução no dispositivo. Quando o serviço do IoT Edge é iniciado pela primeira vez, você só deve ver o módulo edgeAgent em execução. 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.

   • A seção IoT Edge Status mostra o status do serviço e deve indicar ativo (em execução).