Migrar dispositivos e grupos para a versão mais recente da Atualização de Dispositivo para o Hub IoT

Artigo
11/08/2023

À medida que o serviço Atualização de Dispositivo para o Hub IoT lança novas versões, convém atualizar seus dispositivos para obter os recursos e melhorias de segurança mais recentes. Este artigo fornece informações sobre como migrar da versão [Public Preview Refresh(PPR)] para a versão atual do GA. Este artigo também explica o comportamento do grupo e da experiência do usuário nessas versões. Se você não tiver dispositivos, grupos e implantações que usam a versão de atualização do Public Preview, poderá ignorar esta página.

Para migrar com sucesso, você terá que atualizar o agente DU em execução em seus dispositivos. Observe que, como há grandes alterações com a versão GA, recomendamos que você siga as instruções de perto para evitar erros.

Nota

Todos os grupos de dispositivos PPR criados serão automaticamente alterados para grupos GA. Os grupos e dispositivos estarão disponíveis após a migração. O histórico de implantação não será transferido para os grupos de GA atualizados.

Atualizar o agente de Atualização de Dispositivo

Para a versão GA, o agente de Atualização de Dispositivo pode ser atualizado manualmente ou usando o Serviço de Atualização de Dispositivo usando o manifesto apt ou atualizações de imagem. Se você estiver usando atualizações de imagem, poderá incluir o agente de Atualização de Dispositivo do GA na sua atualização.

Atualização manual do agente DU

Antes de atualizar o dispositivo, os atributos do dispositivo incluirão os detalhes do modelo PPR PnP. O Nome do Modelo de Contrato mostrará o Modelo de Atualização de Dispositivo V1 e o ID do Modelo de Contrato mostrará dtmi:azure:iot:deviceUpdateContractModel; 1º.

SSH no seu dispositivo e atualize o agente de Atualização de Dispositivo.

sudo apt install deviceupdate-agent
sudo systemctl restart deviceupdate-agent
sudo systemctl status deviceupdate-agent

Confirme se o agente DU está sendo executado corretamente. Procure por 'HealthCheck passed'
```
sudo -u adu /usr/bin/AducIotAgent -h  
```
Consulte o dispositivo atualizado no portal de Atualização de Dispositivo. Os atributos do dispositivo agora mostrarão os detalhes do modelo PnP atualizado. O Nome do Modelo de Contrato mostrará o Modelo de Atualização de Dispositivo V2 e o ID do Modelo de Contrato mostrará dtmi:azure:iot:deviceUpdateContractModel; 2º.

Atualização do agente OTA DU através do manifesto APT

Antes de atualizar seus dispositivos, os atributos do dispositivo incluirão os detalhes do modelo PPR PnP. O Nome do Modelo de Contrato mostrará o Modelo de Atualização de Dispositivo V1 e o ID do Modelo de Contrato mostrará dtmi:azure:iot:deviceUpdateContractModel; 1º.

Adicione a atualização do agente de atualização de dispositivo como a última etapa da atualização. A versão do manifesto de importação deve ser "4.0" para garantir que é direcionada para os dispositivos corretos. Veja abaixo um exemplo de manifesto de importação e manifesto APT:

Exemplo de manifesto de importação

{
   "manifestVersion": "4",
   "updateId": {
     "provider": "Contoso",
     "name": "Sensor",
     "version": "1.0"
   },
   "compatibility": [
     {
       "manufacturer": "Contoso",
       "model": "Sensor"
     }
   ],
   "instructions": {
     "steps": [
       {
     "handler": "microsoft/apt:1",
     "handlerProperties": {
       "installedCriteria": "1.0"
     },
     "files": [
       "fileId0"
     ]
       }
     ]
   },
   "files": {
     "fileId0": {
       "filename": "sample-upgrade-apt-manifest.json",
       "sizeInBytes": 210,
       "hashes": {
     "sha256": "mcB5SexMU4JOOzqmlJqKbue9qMskWY3EI/iVjJxCtAs="
       }
     }
   },
   "createdDateTime": "2022-08-20T18:32:01.8404544Z"
 }

Exemplo de manifesto APT

  {
    "name": "Sample DU agent upgrade update",
    "version": "1.0.0",
    "packages": [
    {
        "name": "deviceupdate-agent"
    }
    ]
}

Nota

É necessário que a atualização do agente seja a última etapa. Você pode ter outras etapas antes da atualização do agente. Quaisquer etapas adicionadas após a atualização do agente não serão executadas e relatadas corretamente à medida que o dispositivo se reconecta ao serviço DU.

Implante a atualização.
Depois que a atualização for implantada com êxito, os atributos do dispositivo mostrarão os detalhes do modelo PnP atualizado. O Nome do Modelo de Contrato mostrará o Modelo de Atualização de Dispositivo V2 e o ID do Modelo de Contrato mostrará dtmi:azure:iot:deviceUpdateContractModel; 2º.

Comportamento de grupo e implantação entre versões

O dispositivo com o agente Public Preview Refresh DU ( 0.8.x) e o agente GA DU (1.0.x) pode ser gerenciado por meio do portal Device Update.
Dispositivos com agentes mais antigos (0.7.0/0.6.0) não podem ser adicionados a esses grupos.

Próximos passos

Compreender o arquivo de configuração do agente de Atualização de Dispositivo

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