Provisionamento do agente da Atualização de Dispositivo

  • Artigo

O agente do módulo de Atualização de Dispositivo pode ser executado junto com outros processos do sistema e módulos do IoT Edge que se conectam ao seu Hub IoT como parte do mesmo dispositivo lógico. Esta seção descreve como provisionar o agente de Atualização de Dispositivo como uma identidade do módulo.

Alterações no agente de Atualização de Dispositivo na versão de GA

Se estiver usando as versões do agente de Atualização de Dispositivo, migre para a versão 1.0.0 mais recente do agente, que é a versão de GA. Consulte Agente de GA para alterações e como atualizar

Verifique a versão instalada do agente de Atualização de Dispositivo e do agente de Otimização de Entrega na seção Propriedades do Dispositivo do seu dispositivo gêmeo de IoT. Saiba mais sobre as propriedades do dispositivo na Interface do ADU Core.

Identidade do módulo vs identidade do dispositivo

No Hub IoT, em cada identidade do dispositivo, você pode criar até 50 identidades de módulo. Cada identidade de módulo implicitamente gera módulo gêmeo. No lado do dispositivo, os SDKs do dispositivo IoT Hub permitem criar módulos em que cada um abre uma conexão independente para o IoT Hub. A identidade do módulo e o módulo gêmeo fornecem os mesmos recursos que a identidade do dispositivo e o dispositivo gêmeo, mas com granularidade mais precisa. Saiba mais sobre identidades do módulo no Hub IoT

Se você estiver migrando de um agente de nível de dispositivo para adicionar o agente como uma Identidade de Módulo no dispositivo, remova o agente mais antigo que estava se comunicando pelo Dispositivo Gêmeo. Ao provisionar o agente de Atualização de Dispositivo como uma Identidade do Módulo, todas as comunicações entre o dispositivo e o serviço de Atualização de Dispositivo ocorrem no Módulo Gêmeo, portanto, lembre-se de marcar o Módulo Gêmeo do dispositivo ao criar grupos e todas as comunicações devem ocorrer pelo módulo gêmeo.

Suporte para Atualização de Dispositivo

No momento, os seguintes tipos de atualização over the air de dispositivo IoT são compatíveis com a Atualização de Dispositivo:

Pré-requisitos

Se você estiver configurando o dispositivo IoT/IoT Edge para atualizações baseadas em pacote, adicione packages.microsoft.com aos repositórios do seu computador seguindo estas etapas:

  1. Faça logon no computador ou no dispositivo IoT no qual você pretende instalar o agente de Atualização de Dispositivo.

  2. Abra uma janela de terminal.

  3. Instale a configuração do repositório que corresponde ao sistema operacional do seu dispositivo.

    curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list

  4. Copie a lista gerada para o diretório sources.list.d.

    sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/

  5. Instale a chave pública do Microsoft GPG.

    curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg

    sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/

Como provisionar o agente de Atualização de Dispositivo como uma identidade do módulo

Esta seção descreve como provisionar o agente de Atualização de Dispositivo como uma identidade do módulo em

  • Dispositivos habilitados para IoT Edge, ou
  • Dispositivos que não são do IoT Edge, ou
  • Outros dispositivos IoT.

Para verificar se você IoT Edge habilitado em seu dispositivo, consulte as instruções de instalação de IoT Edge.

Siga todas ou qualquer uma das seções abaixo para adicionar o agente de atualização de dispositivo com base no tipo de dispositivo IoT que você está gerenciando.

Em dispositivos habilitados para IoT Edge

Siga estas instruções para provisionar o agente de Atualização de Dispositivo em dispositivos habilitados para IoT Edge.

  1. Siga as instruções para Provisionar manualmente um único dispositivo Azure IoT Edge do Linux.

  2. Instalar o agente de atualização de imagem da Atualização de Dispositivo.

    Fornecemos imagens de exemplo no repositório Ativos aqui. O arquivo swUpdate é a imagem base que você pode instalar em uma placa do Raspberry Pi B3+. O arquivo .gz é a atualização que você importaria por meio da Atualização de Dispositivo para Hub IoT. Para ver um exemplo, confira Como instalar a imagem no dispositivo do Hub IoT.

  3. Instalar o agente de atualização do pacote de Atualização de Dispositivo.

    • Para versões mais recentes do agente packages.microsoft.com: atualize as listas de pacotes em seu dispositivo e instale o pacote do agente de Atualização de Dispositivo e suas dependências usando:

      sudo apt-get update

      sudo apt-get install deviceupdate-agent

    • Para qualquer 'rc', ou seja, versões do agente Release Candidate do Artifacts : baixe o arquivo .deb no computador no qual deseja instalar o agente de Atualização de Dispositivo; em seguida:

      sudo apt-get install -y ./"<PATH TO FILE>"/"<.DEB FILE NAME>"

    • Se você estiver configurando um MCC para um cenário de dispositivo desconectado, instale o plug-in APT de Otimização de Entrega:

      sudo apt-get install deliveryoptimization-plugin-apt

  4. Depois de instalar o agente de atualização do dispositivo, você precisará editar o arquivo de configuração da Atualização de Dispositivo executando o comando abaixo.

    sudo nano /etc/adu/du-config.json

    Altere o connectionType para "AIS" para agentes que usarão o Serviço de Identidade de IoT para provisionamento. O campo ConnectionData deve ser uma cadeia de caracteres vazia. Observe que todos os valores com a marca 'Colocar valor aqui' devem ser definidos. Consulte Configurando um agente de DU.

  5. Agora você está pronto para iniciar o agente de Atualização de Dispositivo em seu dispositivo IoT.

Em dispositivos Linux IoT sem IoT Edge instalados

Siga estas instruções para provisionar o agente de Atualização de Dispositivo nos dispositivos IoT Linux.

  1. Instale o Serviço de Identidade de IoT e adicione a versão mais recente ao dispositivo de IoT seguindo as instruções em Instalando o Serviço de Identidade de Internet das Coisas do Azure.

  2. Configure o Serviço de Identidade de IoT seguindo as instruções em Configurando o Serviço de Identidade de Internet das Coisas do Azure.

  3. Por fim, instale o agente de Atualização de Dispositivo. Fornecemos imagens de exemplo em Ativos aqui, o arquivo swUpdate é a imagem base que você pode usar em uma placa Raspberry Pi B3+, e o arquivo .gz é a atualização que você importaria por meio da Atualização de Dispositivo para Hub IoT. Veja um exemplo de como atualizar a imagem para o dispositivo do Hub IoT.

  4. Depois de instalar o agente de atualização do dispositivo, você precisará editar o arquivo de configuração da Atualização de Dispositivo executando o comando abaixo.

    sudo nano /etc/adu/du-config.json

    Altere o connectionType para "AIS" para agentes que usarão o Serviço de Identidade de IoT para provisionamento. O campo ConnectionData deve ser uma cadeia de caracteres vazia. Observe que todos os valores com a marca 'Colocar valor aqui' devem ser definidos. Consulte Configurando um agente de DU.

  5. Agora você está pronto para iniciar o agente de Atualização de Dispositivo em seu dispositivo IoT.

Outros dispositivos IoT

O agente de Atualização de Dispositivo também pode ser configurado sem o serviço de identidade IoT para teste ou em dispositivos restritos. Siga as etapas abaixo para provisionar o agente de Atualização de Dispositivo usando uma cadeia de conexão (do módulo ou do dispositivo).

  1. Fornecemos imagens de exemplo no repositório Ativos aqui. O arquivo swUpdate é a imagem base que você pode instalar em uma placa do Raspberry Pi B3+. O arquivo .gz é a atualização que você importaria por meio da Atualização de Dispositivo para Hub IoT. Para ver um exemplo, confira Como instalar a imagem no dispositivo do Hub IoT.

  2. Faça logon no computador ou no dispositivo IoT Edge/dispositivo IoT.

  3. Abra uma janela do terminal.

  4. Adicione a cadeia de conexão ao arquivo de configuração de Atualização de Dispositivo:

    1. Insira os comandos abaixo na janela do terminal:

    2. Copie a cadeia de conexão principal

      • Se o agente de Atualização de Dispositivo estiver configurado como um módulo, copie a cadeia de conexão primária do módulo.
      • Caso contrário, copie a cadeia de conexão primária do dispositivo.

    3. Insira a cadeia de conexão primária copiada para o valor do campo 'connectionData' no arquivo du-config.json. Observe que todos os valores com a marca 'Colocar valor aqui' devem ser definidos. Consulte Configurando um agente de DU

  5. Agora você está pronto para iniciar o agente de Atualização de Dispositivo em seu dispositivo IoT.

Como iniciar o agente de Atualização de Dispositivo

Esta seção descreve como iniciar e verificar o agente de Atualização de Dispositivo como uma identidade do módulo executada com êxito em seu dispositivo IoT.

  1. Faça logon no computador ou dispositivo que tem o agente de Atualização de Dispositivo instalado.

  2. Abra uma janela de terminal e insira o comando abaixo.

    sudo systemctl restart deviceupdate-agent

  3. Verifique o status do agente executando o comando abaixo. Se você encontrar problemas, consulte este guia de solução de problemas.

    sudo systemctl status deviceupdate-agent

    Você deverá ver o status OK.

  4. No portal do Hub IoT, vá para dispositivo IoT ou dispositivos IoT Edge para localizar o dispositivo configurado com o agente de Atualização de Dispositivo. Lá, você verá o agente de Atualização de Dispositivo em execução como um módulo. Por exemplo:

    Diagrama do nome do módulo de Atualização de Dispositivo.

Como criar e executar o agente de Atualização de Dispositivo

Você também pode criar e modificar seu agente de Atualização de Dispositivo do cliente. Siga as instruções para criar o agente de Atualização de Dispositivo da origem.

Depois que o agente é criado com êxito, é hora de executá-lo. Agora, faça as alterações necessárias para incorporar o agente em sua imagem. Veja como modificar o agente de Atualização de Dispositivo para obter diretrizes.

Guia de Solução de Problemas

Se você tiver problemas, examine o Guia de solução de problemas de Atualização de Dispositivo para Hub IoT para ajudar na resolução de possíveis problemas e para coletar informações necessárias para fornecer à Microsoft.

Próximas etapas

Você pode usar os seguintes tutoriais para uma demonstração simples da Atualização de Dispositivo para Hub IoT: