Provisionar a Atualização de Dispositivo do Azure para o agente do Hub IoT

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. Este artigo descreve como provisionar o agente de Atualização de Dispositivo como uma identidade de módulo.

Nota

Se utilizar o agente de Atualização de Dispositivo, certifique-se de que está na versão 1.0.0 de disponibilidade geral (GA). Você pode verificar as versões instaladas do agente de Atualização de Dispositivo e do agente de Otimização de Entrega na seção de propriedades do seu dispositivo gêmeo IoT. Para obter mais informações, consulte Migrar dispositivos e grupos para a versão mais recente da Atualização de Dispositivo.

Identidade do módulo e identidade do dispositivo

Você pode criar até 50 identidades de módulo em cada identidade de dispositivo do Hub IoT do Azure. Cada identidade de módulo gera implicitamente um gêmeo de identidade de módulo. No lado do dispositivo, você pode usar os SDKs de dispositivo do Hub IoT para criar módulos que abram uma conexão independente com o Hub IoT.

A identidade do módulo e o gêmeo de identidade do módulo fornecem recursos semelhantes à identidade do dispositivo e ao gêmeo do dispositivo, mas com uma granularidade mais fina. Para obter mais informações, consulte Compreender e usar gêmeos de módulo no Hub IoT.

Quando você provisiona o agente de Atualização de Dispositivo como uma identidade de módulo, todas as comunicações entre o dispositivo e o serviço de Atualização de Dispositivo devem ocorrer pelo módulo gêmeo. Lembre-se de marcar o módulo gêmeo do dispositivo ao criar grupos de dispositivos. Se você migrar de um agente no nível do dispositivo para adicionar o agente como uma identidade de módulo, remova o agente mais antigo que se comunicava pelo gêmeo do dispositivo.

Tipos de atualização suportados

A Atualização de Dispositivo suporta os seguintes tipos de atualização de dispositivo IoT over the air:

• Dispositivos IoT Edge e Linux não IoT Edge:
  • Atualizações de imagem A/B
  • Atualizações de pacotes
  • Atualizações de proxy para dispositivos downstream
• Agente de atualização de dispositivo Eclipse ThreadX
• Dispositivos desconectados atrás de gateways

Preparar-se para atualizações de pacotes

Para configurar um dispositivo IoT ou um dispositivo IoT Edge para instalar atualizações baseadas em pacotes, adicione packages.microsoft.com aos repositórios da sua máquina seguindo estas etapas:

1. Abra uma janela do Terminal na máquina ou dispositivo IoT onde você deseja instalar o agente de Atualização de Dispositivo.

2. Instale a configuração do repositório que corresponde ao sistema operacional do seu dispositivo, por exemplo:

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

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

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

4. Instale a chave pública Microsoft GPG.

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

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

Provisionar o agente de Atualização de Dispositivo

Você pode provisionar o agente de Atualização de Dispositivo como uma identidade de módulo em dispositivos habilitados para IoT Edge ou dispositivos IoT que não sejam IoT Edge. Para verificar se você tem o IoT Edge habilitado em seu dispositivo, consulte Exibir dispositivos registrados e recuperar informações de provisionamento.

Você pode baixar imagens de exemplo para usar na seção Ativos na página Versões . Em Tutorial_RaspberryPi3.zip, o arquivo swUpdate é a imagem base que você pode piscar em uma placa Raspberry Pi B3+. O arquivo .gz é a atualização que você pode importar por meio da Atualização de dispositivo. Para obter mais informações, consulte Atualização de dispositivo do Azure para o Hub IoT usando uma imagem do Raspberry Pi.

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 em Provisionar manualmente um único dispositivo Linux IoT Edge.

2. Instale o agente de atualização de imagem de Atualização de Dispositivo executando o seguinte comando:

   sudo apt-get install deviceupdate-agent
   

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

   • Para obter as versões mais recentes do agente do packages.microsoft.com, atualize as listas de pacotes no 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 versões do agente Release Candidate (rc), baixe o arquivo de .deb de Releases para a máquina na qual você deseja instalar o agente de Atualização de Dispositivo e execute o seguinte comando:

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

   • Se você estiver configurando um Microsoft Connected Cache (MCC) para um cenário de dispositivo desconectado, instale o plug-in APT de otimização de entrega da seguinte maneira:

     sudo apt-get install deliveryoptimization-plugin-apt
     

Em dispositivos não habilitados para IoT Edge

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

1. Instale a versão mais recente do Serviço de Identidade IoT seguindo as instruções em Instalando o Serviço de Identidade IoT do Azure.

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

3. Instale o agente de Atualização de Dispositivo executando o seguinte comando:

   sudo apt-get install deviceupdate-agent
   

Nota

Se o seu dispositivo IoT não conseguir executar o IoT Identity Service ou o IoT Edge, que agrupa o IoT Identity Service, você ainda poderá instalar o agente de Atualização de Dispositivo e configurá-lo usando uma cadeia de conexão.

Configurar o agente de Atualização de Dispositivo

Depois de instalar o agente de atualização de dispositivo, edite o arquivo de configuração de Atualização de Dispositivo executando o seguinte comando.

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

No arquivo du-config.json, defina todos os valores que têm um Place value here espaço reservado. Para agentes que usam o IoT Identity Service para provisionamento, altere o connectionType para AISe defina o ConnectionData campo como uma cadeia de caracteres vazia. Para obter um exemplo, consulte Exemplo de conteúdo do arquivo "du-config.json".

Utilizar uma cadeia de ligação

Para testes ou em dispositivos restritos, você pode configurar o agente de Atualização de Dispositivo sem usar o serviço IoT Identity. Você pode usar uma cadeia de conexão para provisionar o agente de Atualização de Dispositivo a partir do módulo ou dispositivo.

1. No portal do Azure, copie a cadeia de conexão primária. Se o agente de Atualização de Dispositivo estiver configurado como uma identidade de módulo, copie a cadeia de conexão principal do módulo. Caso contrário, copie a cadeia de conexão principal do dispositivo.

2. Em uma janela do Terminal na máquina ou dispositivo IoT onde você instalou o agente de Atualização de Dispositivo, edite o arquivo de configuração da Atualização de Dispositivo executando o seguinte comando:

   • Para um agente Ubuntu: sudo nano /etc/adu/du-config.json.
   • Para uma imagem de referência Yocto: sudo nano /adu/du-config.json.

3. No arquivo du-config.json, defina todos os valores que têm um Place value here espaço reservado e insira a cadeia de conexão primária copiada como o valor do connectionData campo. Para obter um exemplo, consulte Exemplo de conteúdo do arquivo "du-config.json".

Inicie o agente de Atualização de Dispositivo

Inicie o agente de Atualização de Dispositivo e verifique se ele está sendo executado com êxito no seu dispositivo.

1. Em uma janela Terminal na máquina ou dispositivo IoT onde você instalou o agente de Atualização de Dispositivo, reinicie o agente executando o seguinte comando:

   sudo systemctl restart deviceupdate-agent
   

2. Verifique o status do agente executando o seguinte comando.

   sudo systemctl status deviceupdate-agent
   

   Você deve ver o status OK.

3. Na página do portal do Hub IoT, vá para Dispositivos ou IoT Edge para localizar o dispositivo que você configurou e veja o agente de Atualização de Dispositivo em execução como um módulo. Por exemplo:

   

Criar e executar um agente de Atualização de Dispositivo

Você também pode criar e modificar seu próprio agente de Atualização de Dispositivo personalizado. Siga as instruções em Como criar o Device Update Agent para criar o Device Update Agent a partir da origem.

Depois que o agente for compilado com êxito, siga Executando a Atualização de Dispositivo para o Agente de Referência do Hub IoT para executar o agente. Para fazer as alterações necessárias para incorporar o agente em sua imagem, siga Como modificar o código do agente de atualização de dispositivo.

Resolução de Problemas

Se você tiver problemas, consulte o Guia de Solução de Problemas da Atualização de Dispositivo para o Hub IoT para ajudar a resolver os problemas e coletar as informações necessárias para fornecer à Microsoft.

Conteúdos relacionados

• Guia de solução de problemas do Device Update for IoT Hub
• Atualização de dispositivo do Azure para o Hub IoT usando uma imagem do Raspberry Pi
• Atualização de dispositivo do Azure para o Hub IoT usando o agente de pacote do Ubuntu
• Tutorial: Concluir uma atualização de proxy usando a Atualização de Dispositivo para o Hub IoT do Azure
• Atualização de Dispositivo do Azure para Hub IoT usando um agente de simulador
• Atualização de dispositivo para o Hub IoT do Azure usando o Eclipse ThreadX