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

Artigo
06/01/2023

Conforme o serviço da Atualização de Dispositivo para Hub IoT lança novas versões, é recomendável atualizar os dispositivos para os recursos e melhorias de segurança mais recentes. Este artigo fornece informações sobre como migrar da [Versão de PPR (Atualização da Visualização Pública)] para a versão atual, a versão de GA. Este artigo também explica o comportamento do grupo e da UX nessas versões. Você poderá ignorar esta página se não tiver dispositivos, grupos e implantações que usam a Atualização da Visualização Pública.

Você terá que atualizar o agente DU em execução em seus dispositivos para migrar com êxito. Observe que, como há alterações importantes na versão de GA, é recomendável que você siga as instruções com atenção para evitar erros.

Observação

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

Atualizar o agente da Atualização de Dispositivo

Para a versão de GA, o agente da 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 da Atualização de Dispositivo em GA na atualização.

Atualização manual do Agente de DU

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

Entre com SSH em seu dispositivo e atualize o agente da Atualização de Dispositivo.

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

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

Atualização do Agente OTA de DU por meio do manifesto do APT

Antes de você atualizar os dispositivos, os atributos do dispositivo incluirão os detalhes do modelo PnP de PPR. O Nome do Modelo de Contrato mostrará Modelo de Atualização de Dispositivo V1 e a 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 em sua atualização. A versão do manifesto de importação deve ser "4.0" para garantir que ele seja direcionado aos dispositivos corretos. Veja abaixo um manifesto de importação de exemplo e o 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"
    }
    ]
}

Observação

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

Implantar a atualização.
Após a atualização ser implantada com êxito, os atributos do dispositivo mostrarão os detalhes atualizados do modelo de PnP. O Nome do Modelo de Contrato mostrará Modelo de Atualização de Dispositivo V2 e a 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 de DU da Atualização de Visualização Pública ( 0.8.x) e o agente de DU em GA (1.0.x) podem ser gerenciados por meio do portal de Atualização de Dispositivo.
Dispositivos com agentes mais antigos (0.7.0/0.6.0) não podem ser adicionados a esses grupos.

Próximas etapas

Entender 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 Hub IoT:

Compartilhar via