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

Перенос устройств и групп из общедоступной предварительной версии в обновление общедоступной предварительной версии

  • Статья

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

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

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

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

  1. Чтобы просмотреть устройства, использующие старые агенты (версии 0.7.0/0.6.0) и группы, созданные до 3 февраля 2022 г., перейдите на общедоступный портал предварительной версии, доступ к которому можно получить через баннер.

    Снимок экрана: баннер.

  2. Создайте устройство IoT / IoT Edge на портале Azure. Скопируйте основную строку подключения для устройства из представления устройства для последующего использования. Дополнительные сведения см. в разделе Добавление устройства в Центр Интернета вещей.

  3. Затем подключитесь к устройству по SSH и удалите все старые агенты Обновления устройств.

    sudo apt remove deviceupdate-agent 
sudo apt remove adu-agent

  4. Удалите старый файл конфигурации.

    sudo rm -f /etc/adu/adu-conf.txt

  5. Установите новый агент.

    sudo apt-get install deviceupdate-agent

    В качестве альтернативы можно получить ресурс .deb из репозитория GitHub и установить агент.

    sudo apt install <file>.deb

    Попытка обновить агент Обновления устройств без удаления старого агента и файлов конфигурации приведет к ошибке, показанной ниже.

    Снимок экрана: ошибка обновления.

  6. Введите основную строку подключения вашего устройства IoT (или модуля, в зависимости от того, как вы подготовили устройство с помощью Обновления устройств) в файле конфигурации, выполнив приведенную ниже команду:

    sudo nano /etc/adu/du-config.json

  7. Добавление модели, производителя, имени агента, типа подключения и других сведений в файл конфигурации

  8. Удалите старое устройство IoT / IoT Edge на общедоступном портале предварительной версии.

Примечание

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

Перенос групп в обновление общедоступной предварительной версии

  1. Если на ваших устройствах используется агент Обновления устройств версии 0.6.0 или 0.7.0, обновите его до последней версии 0.8.0, выполнив описанные выше действия.

  2. Удалите существующие группы на портале общедоступной предварительной версии, перейдя по ссылке в баннере.

  3. Добавьте тег группы к двойнику устройства для обновленных устройств. Дополнительные сведения см. в разделе Добавление тега к устройству.

  4. Повторно создайте группы на портале PPR, перейдя в раздел "Добавление групп" и выбрав соответствующий тег групп из раскрывающегося списка.

  5. Обратите внимание, если группа на портале общедоступного предварительного просмотра не удалена, что создание группы с таким же именем на портале PPR невозможно.

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

  • Группы, созданные на портале обновления общедоступной предварительной версии, разрешают только добавление устройств с помощью последней версии агента Обновления устройств (0.8.0). Устройства со старыми версиями агентов (0.7.0/0.6.0) нельзя добавить в эти группы.

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

  • Для устройства, использующего последнюю версию агента: если тег группы добавлен к свойствам устройства, но соответствующая группа еще не создана, устройство не будет отображаться на вкладке "Группы и развертывания".

  • Устройства, использующие старые версии агентов, будут отображаться как разгруппированные на старом портале, если тег группы не добавлен.

Дальнейшие действия

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

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