Tutorial: Concluir uma atualização de proxy com a Atualização de Dispositivos para Hub IoT do Azure

Artigo
03/24/2023

Se ainda não o fez, veja Utilizar atualizações de proxy com a Atualização de Dispositivos para Hub IoT do Azure.

Configurar um dispositivo de teste ou uma máquina virtual

Este tutorial utiliza uma máquina virtual (VM) do Ubuntu Server 18.04 LTS como exemplo.

Instalar o Agente de Atualização de Dispositivos e as dependências

Registe packages.microsoft.com num repositório de pacotes APT:

sudo apt-get update

sudo apt install curl

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

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

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

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

sudo apt-get update

Instale o deviceupdate-agent no dispositivo IoT. Transfira o ficheiro Debian de Atualização de Dispositivos mais recente a partir de packages.microsoft.com:
```
sudo apt-get install deviceupdate-agent
```
Em alternativa, copie o ficheiro Debian transferido para a VM de teste. Se estiver a utilizar o PowerShell no computador, execute o seguinte comando da shell:
```
scp <path to the .deb file> tester@<your vm's ip address>:~
```
Em seguida, aceda remotamente à VM e execute o seguinte comando de shell na pasta home page:
```
#go to home folder 
cd ~
#install latest Device Update agent
sudo apt-get install ./<debian file name from the previous step>
```
Aceda a Hub IoT do Azure e copie a cadeia de ligação primária para o módulo Atualização de Dispositivos do seu dispositivo IoT. Substitua qualquer valor predefinido para o connectionData campo pela cadeia de ligação primária no ficheiro du-config.json :
```
sudo nano /etc/adu/du-config.json  
```
Nota

Em vez disso, pode copiar a cadeia de ligação primária para o dispositivo, mas recomendamos que utilize a cadeia para o módulo Atualização de Dispositivos. Para obter informações sobre como configurar o módulo, veja Aprovisionamento do Agente de Atualização de Dispositivos.

Certifique-se de que /etc/adu/du-diagnostics-config.json contém as definições corretas para a coleção de registos. Por exemplo:

{
  "logComponents":[
    {
      "componentName":"adu",
       "logPath":"/var/log/adu/"
    },
    {
      "componentName":"do",
      "logPath":"/var/log/deliveryoptimization-agent/"
    }
  ],
  "maxKilobytesToUploadPerLogPath":50
}

Reinicie o agente de Atualização de Dispositivos:
```
sudo systemctl restart deviceupdate-agent
```

Configurar componentes de simulação

Para fins de teste e demonstração, vamos criar os seguintes componentes simulados no dispositivo:

Três motores
Duas câmaras
"hostfs"
"rootfs"

Importante

A configuração do componente anterior baseia-se na implementação de uma extensão de enumerador de componentes de exemplo denominada libcontoso-component-enumerator.so. Também requer este ficheiro de dados de inventário de componentes simulados: /usr/local/contoso-devices/components-inventory.json.

Copie a pasta de demonstração para o diretório principal na VM de teste. Em seguida, execute o seguinte comando para copiar os ficheiros necessários para as localizações certas:
```
`~/demo/tools/reset-demo-components.sh` 
```
O reset-demo-components.sh comando segue os seguintes passos em seu nome:
- Copia components-inventory.json e adiciona-o à pasta /usr/local/contoso-devices .
- Copia a extensão do enumerador de componentes da Contoso (libcontoso-component-enumerator.so) da pasta Recursos e adiciona-a à pasta /var/lib/adu/extensions/sources .
- Regista a extensão:
```
sudo /usr/bin/AducIotAgent -E /var/lib/adu/extensions/sources/libcontoso-component-enumerator.so
```

Importar uma atualização de exemplo

Se ainda não o fez, crie uma conta e instância de Atualização de Dispositivos, incluindo a configuração de um hub IoT. Em seguida, inicie o procedimento seguinte.

A partir da versão mais recente da Atualização de Dispositivos, em Recursos, transfira os manifestos de importação e imagens para atualizações de proxy.
Inicie sessão no portal do Azure e aceda ao seu hub IoT com a Atualização de Dispositivos. No painel esquerdo, selecione Gestão de Dispositivos>Atualizações.
Selecione o separador Atualizações.
Selecione + Importar Nova Atualização.
Selecione + Selecionar a partir do contentor de armazenamento e, em seguida, selecione a sua conta de armazenamento e contentor.
Selecione Carregar para adicionar os ficheiros que transferiu no passo 1.
Carregue o manifesto de importação principal, o manifesto de importação de menores e os ficheiros payload para o contentor.

O exemplo seguinte mostra os ficheiros de exemplo carregados para atualizar as câmaras ligadas a um dispositivo de aspirador inteligente. Também inclui um script de pré-instalação para desativar as câmaras antes da atualização para o ar.

No exemplo, o manifesto de importação principal é contoso. Virtual-Vacuum-virtual-camera.1.4.importmanifest.json. O manifesto de importação subordinado com detalhes para atualizar a câmara é Contoso.Virtual-Vacuum.3.3.importmanifest.json. Ambos os nomes de ficheiros de manifesto seguem o formato necessário e terminam com .importmanifest.json.
Escolha Selecionar.
A IU mostra agora a lista de ficheiros que serão importados para a Atualização de Dispositivos. Selecione Importar atualização.
O processo de importação é iniciado e o ecrã muda para a secção Histórico de Importações . Selecione Atualizar para ver o progresso até que o processo de importação seja concluído. Dependendo do tamanho da atualização, a importação poderá terminar dentro de alguns minutos ou demorar mais tempo.
Quando a coluna Estado indicar que a importação foi efetuada com êxito, selecione o separador Disponível Atualizações. Deverá ver a atualização importada na lista agora.

Para obter mais informações sobre o processo de importação, veja Importar uma atualização para a Atualização de Dispositivos.

Ver grupos de dispositivos

A Atualização de Dispositivos utiliza grupos para organizar dispositivos. A Atualização de Dispositivos ordena automaticamente os dispositivos em grupos com base nas respetivas etiquetas atribuídas e propriedades de compatibilidade. Cada dispositivo pertence apenas a um grupo, mas os grupos podem ter vários subgrupos para ordenar classes de dispositivos diferentes.

Aceda ao separador Grupos e Implementações na parte superior da página.
Veja a lista de grupos e o gráfico de conformidade de atualização. O gráfico de conformidade de atualização mostra a contagem de dispositivos em vários estados de conformidade: na atualização mais recente, novas atualizações disponíveis e Atualizações em curso. Saiba mais sobre a conformidade de atualizações.
Deverá ver um grupo de dispositivos que contém o dispositivo simulado que configurou neste tutorial, juntamente com quaisquer atualizações disponíveis para os dispositivos no novo grupo. Se existirem dispositivos que não cumpram os requisitos de classe do dispositivo do grupo, estes serão apresentados num grupo inválido correspondente. Para implementar a melhor atualização disponível para o novo grupo definido pelo utilizador a partir desta vista, selecione Implementar junto ao grupo.

Para obter mais informações sobre etiquetas e grupos, veja Gerir grupos de dispositivos.

Implementar atualização

Assim que o grupo for criado, deverá ver uma nova atualização disponível para o grupo de dispositivos, com uma ligação para a atualização em Melhor Atualização (poderá ter de Atualizar uma vez).

Para obter mais informações sobre conformidade, veja Conformidade com a Atualização de Dispositivos.
Selecione o grupo de destino clicando no nome do grupo. Será direcionado para os detalhes do grupo em Noções básicas do grupo.
Para iniciar a implementação, aceda ao separador Implementação atual. Selecione a ligação implementar junto à atualização pretendida na secção Atualizações disponíveis. A melhor atualização disponível para um determinado grupo será indicada com um realce "Best".
Agende a implementação para começar imediatamente ou no futuro e, em seguida, selecione Criar.
O Estado em Detalhes da implementação deve mudar para Ativo e a atualização implementada deve ser marcada com "(deploying)".
Ver o gráfico de conformidade. Deverá ver que a atualização está em curso.
Depois de o seu dispositivo ser atualizado com êxito, deverá ver que o gráfico de conformidade e os detalhes da implementação são atualizados para refletir o mesmo.