Partilhar via


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

À 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

  1. 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º.

  2. 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
    
  3. Confirme se o agente DU está sendo executado corretamente. Procure por 'HealthCheck passed'

    sudo -u adu /usr/bin/AducIotAgent -h  
    
  4. 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

  1. 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º.

  2. 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.

  1. Implante a atualização.

  2. 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: