Руководство по обновлению устройства для Центр Интернета вещей Azure с помощью агента пакета в Ubuntu Server 22.04 x64

Статья
10/31/2024

Обновление устройств для Центра Интернета вещей Azure поддерживает обновления на основе образов, пакетов и скриптов.

Обновления на основе пакетов являются целевыми и изменяют только конкретный компонент или приложение на устройстве. Благодаря этому меньше используется пропускная способность, а также ускоряются процессы скачивания и установки обновления. Обновления на основе пакетов, как правило, также позволяют сократить время простоя обновляемых устройств и избежать расходов, связанных с созданием образов. Они используют Манифест APT, который предоставляет агенту Обновления устройств сведения, необходимые для загрузки и установки пакетов, указанных в файле манифеста APT (а также их зависимостях) из указанного репозитория.

В этом руководстве описывается обновление Azure IoT Edge в Ubuntu Server 22.04 x64 с помощью агента пакета обновления устройства. Хотя в этом руководстве показано, как установить Microsoft Defender для Интернета вещей, с помощью аналогичных действий можно обновить другие пакеты, такие как сам IoT Edge или обработчик контейнеров, который он использует.

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

Из этого руководства вы узнаете, как выполнять следующие задачи:

Скачивание и установка агента Обновления устройств и его зависимостей.
Добавление тега к устройству.
Импорт обновлений.
Развертывание обновления пакета.
Отслеживайте развертывание обновления.

Необходимые компоненты

Если вы еще это не сделали, создайте учетную запись и экземпляр Обновления устройств. Настройте центр Интернета вещей.
Вам потребуется строка подключения для устройства IoT Edge.
Если вы использовали руководство по агенту симулятора для предварительного тестирования, выполните следующую команду, чтобы вызвать обработчик APT и развернуть беспроводные обновления пакетов для этого руководства.
```
sudo /usr/bin/AducIotAgent --register-content-handler /var/lib/adu/extensions/sources/libmicrosoft_apt_1.so --update-type 'microsoft/apt:1'
```

Подготовка устройства

Использование кнопки автоматического развертывания в Azure

Для удобства в этом руководстве используется шаблон Azure Resource Manager на основе облака, чтобы быстро настроить виртуальную машину Ubuntu 22.04 LTS(виртуальная машина). Он устанавливает как среду выполнения Azure IoT Edge, так и агент пакета Обновления устройств. Затем он автоматически настраивает устройство с помощью сведений о подготовке, используя строку подключения устройства для предоставленного устройства IoT Edge (предварительное требование). Шаблон Resource Manager также позволяет избежать необходимости запускать сеанс SSH для завершения установки.

Чтобы начать работу, нажмите кнопку.

.
Заполните доступные текстовые поля.
- Подписка. Активная подписка Azure для развертывания виртуальной машины.
- Группа ресурсов. Существующая или только что созданная группа ресурсов, содержащая виртуальную машину и связанные с ней ресурсы.
- Регион. Географический регион для развертывания виртуальной машины. По умолчанию это значение равно расположению выбранной группы ресурсов.
- Префикс метки DNS. Необходимое значение, которое используется для добавления префикса имени узла виртуальной машины.
- Имя пользователя администратора. Имя пользователя, которому при развертывании предоставляются привилегии суперпользователя.
- Строка подключения устройства. Строка подключения для устройства, созданного в предполагаемом центре Интернета вещей.
- Размер виртуальной машины. Размер развертываемой виртуальной машины.
- Версия ОС Ubuntu. Версия операционной системы Ubuntu, устанавливаемая на базовую виртуальную машину. Оставьте значение по умолчанию неизменным, так как оно уже имеет значение Ubuntu 22.04-LTS.
- Тип проверки подлинности. Выберите sshPublicKey или пароль в зависимости от ваших предпочтений.
- Пароль или ключ администратора. Значение открытого ключа SSH или значение пароля в зависимости от выбранного типа проверки подлинности.
После заполнения всех полей установите флажок в нижней части страницы, чтобы принять условия. Щелкните Приобрести, чтобы начать развертывание.
Убедитесь, что развертывание выполнено успешно. Подождите несколько минут после развертывания, чтобы дать процессам после установки и настройки завершить установку IoT Edge и агента пакета Обновления устройств.

Ресурс виртуальной машины должен быть развернут в выбранной группе ресурсов. Запишите имя компьютера в формате vm-0000000000000. Кроме того, запишите связанное DNS-имя в формате <dnsLabelPrefix>.<location>.cloudapp.azure.com.

DNS-имя указано в разделе Обзор развернутой виртуальной машины на портале Azure.

Совет

Чтобы после завершения установки подключиться к этой виртуальной машине по протоколу SSH, используйте соответствующее DNS-имя с помощью команды ssh <adminUsername>@<DNS_Name>.
Установите агент обновления устройств на виртуальной машине.
```
sudo apt-get install deviceupdate-agent
```
Откройте сведения о конфигурации (см. инструкции по настройке файла конфигурации с помощью приведенной ниже команды. Задайте для параметра connectionType значение "AIS", а для connectionData — пустую строку. Обратите внимание, что все значения с тегом "Место здесь" должны быть заданы. См. сведения о настройке агента обновления устройств.
```
sudo nano /etc/adu/du-config.json
```
Перезапустите агент обновления устройств.
```
sudo systemctl restart deviceupdate-agent
```

На программные пакеты Обновления устройств для Центра Интернета вещей Azure распространяются условия следующих лицензий:

Прочтите условия лицензионного соглашения перед использованием пакета. Установка и использование пакета означают, что вы принимаете эти условия. Если вы с ними не согласны, не используйте пакет.

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

Войдите на портал Azure и перейдите в Центр Интернета вещей.
На левой панели в разделе "Устройства" найдите устройство IoT Edge и перейдите к двойнику двойника устройства или двойника модуля.
В двойнике модуля агента Обновления устройств удалите все существующие значения тегов обновления устройства, присвоив им значение NULL. Если вы используете удостоверение устройства с агентом Обновления устройств, внесите эти изменения в двойник устройства.
Добавьте новое значение тега Обновления устройств, как показано ниже.
```
    "tags": {
        "ADUGroup": "<CustomTagValue>"
    },
```
На этом снимке экрана показан раздел, в котором необходимо добавить тег в двойник.

Импорт обновления

Перейдите на страницу выпусков Обновления устройств в GitHub и щелкните раскрывающийся список Assets (Ресурсы). Выберите Tutorial_IoTEdge_PackageUpdate.zip для скачивания. Извлеките содержимое папки для обнаружения примера манифеста APT (sample-defender-iot-apt-manifest.json) и соответствующего манифеста импорта (sample-defender-iot--importManifest.json).
Войдите на портал Azure и перейдите в свой центр Интернета вещей с Обновлением устройств. В области слева в разделе Автоматическое управление устройствами выберите Обновления.
Откройте вкладку Обновления.
Щелкните + Импортировать новое обновление.
Щелкните + Выбрать из контейнера хранилища. Выберите существующую учетную запись или создайте новую, щелкнув + Учетная запись хранения. Затем выберите существующий контейнер или создайте новый, щелкнув + Контейнер. Этот контейнер будет использоваться для размещения файлов обновления для импорта.

Примечание.

Мы рекомендуем использовать новый контейнер каждый раз при импорте обновления, чтобы избежать случайного импорта файлов из предыдущих обновлений. Если вы не будете использовать новый контейнер, обязательно удалите все файлы из существующего контейнера, прежде чем завершить этот шаг.
В контейнере щелкните Отправка и перейдите к файлам, скачанным на шаге 1. Выбрав все файлы обновления, щелкните Отправить. Затем щелкните Выбрать, чтобы вернуться на страницу Импорт обновления.

На этом снимке экрана показан шаг импорта. Имена файлов могут не совпадать с именами, которые используются в примере.
На странице Импорт обновления проверьте импортируемые файлы. Затем щелкните Импорт обновления, чтобы начать процесс импорта.
Начнется процесс импорта, а на экране появится раздел Журнал импорта. Если столбец Состояние указывает на то, что импорт успешно выполнен, выберите заголовок Доступные обновления. Импортированное обновление должно появиться в списке.

Дополнительные сведения о процессе импорта см. в разделе "Импорт обновления устройства".

Просмотр групп устройств

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

Откройте вкладку Группы и развертывания в верхней части страницы.
Просмотрите список групп и диаграмму соответствия обновления. На схеме соответствия обновлений требованиям отображается количество устройств в разных состояниях соответствия: При последнем обновлении, Доступны новые обновления и Выполняющиеся обновления. Подробнее о соответствии обновлений.
Вы увидите группу устройств, содержащую имитированное устройство, настроенное в этом руководстве, вместе с любыми доступными обновлениями для устройств в новой группе. Если есть устройства, которые не соответствуют требованиям к классу устройств в группе, они отобразятся в соответствующей группе недопустимых устройств. Чтобы развернуть наилучшее доступное обновление в новой определяемой пользователем группе из этого представления, выберите Развернуть рядом с группой.

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

Развертывание обновления

После создания группы должно появиться новое обновление, доступное для вашей группы устройств. Ссылка на него будет отображаться в разделе Лучшее обновление. Возможно, потребуется выполнить обновление один раз.

Дополнительные сведения о соответствии требованиям см. в разделе "Соответствие обновлению устройств".
Выберите целевую группу, указав ее имя. Откроются сведения о группе в разделе Основные сведения о группе.
Чтобы начать развертывание, перейдите на вкладку Текущее развертывание. Щелкните ссылку Развернуть рядом с нужным обновлением в разделе Доступные обновления. Наилучшее доступное обновление для указанной группы обозначается как Лучшее.
Запланируйте запуск развертывания немедленно или в будущем. Затем выберите Создать.

Совет

По умолчанию дата и время запуска — это 24 часа начиная от текущего времени. Если вы хотите, чтобы развертывание началось раньше, выберите другие дату и время.
В разделе Сведения о развертывании для параметра Состояние задается значение Активно. Развернутое обновление помечается как (развертывается).
Просмотрите схему соответствия, чтобы убедиться, что обновление выполняется.
После успешного обновления устройства вы увидите, что диаграмма соответствия и сведения о развертывании обновляются так же.

Слежение за развертыванием обновления

Щелкните вкладку Журнал развертываний в верхней части страницы.
Щелкните ссылку Сведения рядом с созданным развертыванием.
Щелкните Обновить, чтобы просмотреть последние данные о состоянии.

Теперь вы завершили успешное комплексное обновление пакета с помощью обновления устройства для Центр Интернета вещей на устройстве Ubuntu Server 22.04 x64.

Очистка ресурсов

Очистите учетную запись и экземпляр Обновления устройств, а также центр Интернета вещей, если они больше не нужны. Также очистите устройство IoT Edge, если вы создали виртуальную машину с помощью кнопки Развернуть в Azure. Чтобы очистить ресурсы, перейдите к каждому отдельному ресурсу и щелкните Удалить. Очистите экземпляр Обновления устройств перед очисткой учетной записи Обновления устройств.

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

Обновление компонентов устройства или подключенных датчиков с помощью обновления устройства

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