Перенос устройств и групп в последнюю версию обновления устройств для выпуска Центр Интернета вещей

Статья
11/08/2023

По мере выпуска новых версий службы "Обновление устройств для Центра Интернета вещей" вам нужно будет обновлять свои устройства, чтобы получить доступ к новейшим функциям и улучшениям системы безопасности. В этой статье содержатся сведения о переносе из [выпуска общедоступного предварительного обновления (PPR) в текущий выпуск общедоступной версии. В этой статье также объясняется поведение группы и пользовательского интерфейса в этих выпусках. Если у вас нет устройств, групп и развертываний, использующих выпуск обновления общедоступной предварительной версии, вы можете игнорировать эту страницу.

Для успешного переноса нужно обновить агент Обновления устройств, работающий на ваших устройствах. Обратите внимание, что при наличии основных изменений в выпуске общедоступной версии рекомендуется внимательно следовать инструкциям, чтобы избежать ошибок.

Примечание.

Все группы устройств PPR, созданные, будут автоматически изменены на группы общедоступной версии. Группы и устройства будут доступны после миграции. Журнал развертывания не будет переноситься в обновленные группы общедоступной версии.

Обновление агента обновления устройства

В выпуске общедоступной версии агент обновления устройств можно обновить вручную или с помощью службы обновления устройств с помощью манифеста apt или обновлений изображений. Если вы используете обновления изображений, вы можете включить агент обновления устройств общедоступной версии в обновление.

Обновление агента DU вручную

Перед обновлением устройства атрибуты устройства будут содержать сведения о модели PPR PnP. Имя модели контракта отображает модель обновления устройства версии 1 и идентификатор модели контракта будет отображать dtmi:azure:iot:deviceUpdateContractModel; 1.

SSH на устройстве и обновление агента обновления устройств.

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

Убедитесь, что агент DU работает правильно. Найдите "HealthCheck передано"
```
sudo -u adu /usr/bin/AducIotAgent -h  
```
Просмотрите обновленное устройство на портале обновления устройств. Теперь атрибуты устройства будут отображать обновленные сведения о модели PnP. Имя модели контракта отображает модель обновления устройства версии 2 и идентификатор модели контракта будет отображать dtmi:azure:iot:deviceUpdateContractModel; 2.

Обновление агента OTA DU, хотя манифест APT

Перед обновлением устройств атрибуты устройства будут включать сведения о модели PPR PnP. Имя модели контракта отображает модель обновления устройства версии 1 и идентификатор модели контракта будет отображать dtmi:azure:iot:deviceUpdateContractModel; 1.

Добавьте обновление агента обновления устройства в качестве последнего шага в обновлении. Версия манифеста импорта должна быть "4.0" , чтобы убедиться, что она предназначена для правильных устройств. Ниже приведен пример манифеста импорта и манифеста APT:

Пример манифеста импорта

{
   "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"
 }

Пример манифеста APT

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

Примечание.

Для обновления агента необходимо выполнить последний шаг. Вы можете выполнить другие действия перед обновлением агента. Все действия, добавленные после обновления агента, не будут выполнены и сообщались правильно, так как устройство повторно подключается к службе DU.

Развертывание обновления.
После успешного развертывания обновления атрибуты устройства будут отображать обновленные сведения о модели PnP. Имя модели контракта отображает модель обновления устройства версии 2 и идентификатор модели контракта будет отображать dtmi:azure:iot:deviceUpdateContractModel; 2.

Поведение групп и развертывания в разных выпусках

Устройство с агентом DU обновления общедоступной предварительной версии (0.8.x) и агентом GA DU (1.0.x) можно управлять с помощью портала обновления устройств.
Устройства со старыми версиями агентов (0.7.0/0.6.0) нельзя добавить в эти группы.

Следующие шаги

Общие сведения о файле конфигурации агента Обновления устройств

Вы можете использовать следующие руководства для простой демонстрации Обновления устройств для Центра Интернета вещей:

Поделиться через