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

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

  • Статья

Агент модуля обновления устройств может выполняться вместе с другими системными процессами и модулями IoT Edge, которые подключаются к Центр Интернета вещей как часть того же логического устройства. В этой статье описывается подготовка агента обновления устройств в качестве удостоверения модуля.

Примечание.

Если вы используете агент обновления устройств, убедитесь, что вы находитесь в общедоступной версии версии 1.0.0. Вы можете проверить установленные версии агента обновления устройств и агента оптимизации доставки в разделе свойств двойника устройства Интернета вещей. Дополнительные сведения см. в разделе "Миграция устройств и групп" в последний выпуск обновления устройств.

Удостоверение модуля и удостоверение устройства

Вы можете создавать до 50 удостоверений модулей под каждым Центр Интернета вещей Azure удостоверением устройства. Каждое удостоверение модуля неявно создает двойник удостоверения модуля. На стороне устройства можно использовать пакеты SDK для Центр Интернета вещей устройств для создания модулей, каждый из которых открывает независимое подключение к Центр Интернета вещей.

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

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

Поддерживаемые типы обновлений

Обновление устройства поддерживает следующие устройства Интернета вещей по типам обновления воздуха:

Подготовка к обновлению пакета

Чтобы настроить устройство Интернета вещей или устройство IoT Edge для установки обновлений на основе пакетов, добавьте packages.microsoft.com в репозитории компьютера, выполнив следующие действия.

  1. Откройте окно терминала на компьютере или устройстве Интернета вещей, где требуется установить агент обновления устройств.

  2. Установите конфигурацию репозитория, соответствующую операционной системе устройства, например:

    curl https://packages.microsoft.com/config/ubuntu/18.04/multiarch/prod.list > ./microsoft-prod.list

  3. Скопируйте созданный список в каталог sources.list.d .

    sudo cp ./microsoft-prod.list /etc/apt/sources.list.d/

  4. Установите открытый ключ Microsoft GPG.

    curl https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > microsoft.gpg

    sudo cp ./microsoft.gpg /etc/apt/trusted.gpg.d/

Подготовка агента обновления устройств

Агент обновления устройств можно подготовить в качестве удостоверения модуля на устройствах с поддержкой IoT Edge или устройствах, отличных от IoT Edge. Чтобы проверить, включена ли на устройстве ioT Edge, просмотрите сведения о зарегистрированных устройствах и получите сведения о подготовке.

Примеры образов можно скачать из раздела "Ресурсы " на странице "Выпуски ". В Tutorial_RaspberryPi3.zip файл swUpdate — это базовый образ, который можно запустить на доске Raspberry Pi B3+. Файл .gz — это обновление, которое можно импортировать с помощью обновления устройства. Дополнительные сведения см. в разделе "Обновление устройств Azure" для Центр Интернета вещей с помощью образа Raspberry Pi.

Устройства с поддержкой IoT Edge

Выполните следующие инструкции, чтобы подготовить агент обновления устройств на устройствах с поддержкой IoT Edge:

  1. Следуйте инструкциям, приведенным в руководстве по подготовке одного устройства Linux IoT Edge.

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

    sudo apt-get install deviceupdate-agent

  3. Установите агент обновления пакета обновления устройства.

    • Для последних версий агента из packages.microsoft.com обновите списки пакетов на устройстве и установите пакет агента обновления устройств и его зависимости с помощью:

      sudo apt-get update

      sudo apt-get install deviceupdate-agent

    • Для версий агента кандидата выпуска (rc) скачайте файл .deb из выпусков на компьютер, на котором вы хотите установить агент обновления устройств, а затем выполните следующую команду:

      sudo apt-get install -y ./"<PATH TO FILE>"/"<.DEB FILE NAME>"

    • Если вы настраиваете подключенный кэш Майкрософт (MCC) для сценария отключенного устройства, установите подключаемый модуль APT оптимизации доставки следующим образом:

      sudo apt-get install deliveryoptimization-plugin-apt

На устройствах, не поддерживающих IoT Edge

Следуйте этим инструкциям, чтобы подготовить агент обновления устройств на устройствах Linux IoT без установки IoT Edge.

  1. Установите последнюю версию службы удостоверений Интернета вещей, следуя инструкциям по установке службы удостоверений Azure IoT.

  2. Настройте службу идентификации Интернета вещей, следуя инструкциям в раздела Настройка службы идентификации Интернета вещей Azure.

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

    sudo apt-get install deviceupdate-agent

Примечание.

Если устройство Интернета вещей не может запустить службу удостоверений Интернета вещей или IoT Edge, которая объединяет службу удостоверений Интернета вещей, вы по-прежнему можете установить агент обновления устройств и настроить его с помощью строка подключения.

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

После установки агента обновления устройства измените файл конфигурации обновления устройства, выполнив следующую команду.

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

В файле du-config.json задайте все значения, имеющие Place value here заполнитель. Для агентов, использующих службу удостоверений Интернета вещей для подготовки, измените connectionType AISзначение на и задайте ConnectionData поле пустой строкой. Пример см . в примере содержимого файла "du-config.json".

использование строки подключения;

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

  1. Скопируйте основной строка подключения в портал Azure. Если агент обновления устройств настроен в качестве удостоверения модуля, скопируйте основной строка подключения модуля. В противном случае скопируйте основной строка подключения устройства.

  2. В окне терминала на компьютере или устройстве Интернета вещей, на котором установлен агент обновления устройств, измените файл конфигурации обновления устройства, выполнив следующую команду:

  3. В файле du-config.json задайте все значения, имеющие Place value here заполнитель, и введите скопированные первичные строка подключения в качестве connectionData значения поля. Пример см . в примере содержимого файла "du-config.json".

Запуск агента обновления устройств

Запустите агент обновления устройств и убедитесь, что он успешно работает на устройстве.

  1. В окне терминала на компьютере или устройстве Интернета вещей, на котором установлен агент обновления устройств, перезапустите агент, выполнив следующую команду:

    sudo systemctl restart deviceupdate-agent

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

    sudo systemctl status deviceupdate-agent

    Должно появиться состояние OK.

  3. На странице портала Центр Интернета вещей перейдите к устройствам или IoT Edge, чтобы найти настроенное устройство и просмотреть агент обновления устройств, работающий в качестве модуля. Например:

    Схема имени модуля обновления устройства с состоянием

Включение агента обновления устройств за прокси-сервером

Устройства, на которых работает агент обновления устройств, отправляют HTTPS-запросы для обмена данными с Центр Интернета вещей. Если устройство подключено к сети, использующую прокси-сервер, необходимо настроить службу обновления устройств для обмена данными через сервер.

Перед настройкой обновления устройства убедитесь, что у вас есть URL-адрес прокси-сервера. URL-адрес прокси-сервера находится в формате protocol://proxy_host:proxy_port.

Перейдите к конфигурации обновления устройства, выполнив следующую команду:

sudo systemctl edit deviceupdate-agent.service

Добавление сведений о прокси-сервере в конфигурацию

[Service]
Environment="https_proxy=<Proxy URL>"

Перезапустите агент, чтобы применить изменения:

sudo systemctl daemon-reload
sudo systemctl restart deviceupdate-agent
sudo systemctl status deviceupdate-agent

Создание и запуск агента обновления устройства

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

После успешной сборки агента выполните обновление устройства для Центр Интернета вещей эталонного агента, чтобы запустить агент. Чтобы внести изменения, необходимые для включения агента в образ, следуйте инструкциям по изменению кода агента обновления устройства.

Устранение неполадок

При возникновении проблем ознакомьтесь с руководством по устранению неполадок с обновлением устройств для Центр Интернета вещей, чтобы устранить проблемы и собрать необходимые сведения для предоставления корпорации Майкрософт.

Связанный контент