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

Обновление IoT Edge

Применимо к:IoT Edge 1.5 флажок IoT Edge 1.5 IoT Edge 1.4 флажок IoT Edge 1.4

Внимание

IoT Edge 1.5 LTS — это поддерживаемый выпуск. IoT Edge 1.4 LTS заканчивается жизнью с 12 ноября 2024 года.

Поскольку служба IoT Edge выпускает новые версии, обновите IoT Edge устройства для последних функций и улучшений безопасности. В этой статье содержатся сведения об обновлении устройств IoT Edge при наличии новой версии.

Если вы хотите перейти к новой версии, необходимо обновить два логических компонента устройства IoT Edge.

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

  • IoT Edge runtime — среда выполнения IoT Edge состоит из модулей IoT Edge hub (edgeHub) и агентов IoT Edge (edgeAgent). В зависимости от структуры развертывания можно обновить среду выполнения с устройства или удаленно.

Способ обновления

Используйте разделы этой статьи, чтобы обновить подсистему безопасности и контейнеры среды выполнения на устройстве.

Выпуски исправлений

При обновлении между выпусками исправлений , например 1.5.1 до 1.5.2, порядок обновления не важен. Подсистему безопасности или контейнеры среды выполнения можно обновить до или после другого. Для обновления между версиями патчей:

  1. Обновление подсистемы безопасности
  2. Обновление контейнеров среды выполнения
  3. Проверка соответствия версий

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

Основные или незначительные выпуски

При обновлении между основными или дополнительными выпусками, например с версии 1.4 до 1.5, обновите подсистему безопасности и контейнеры среды выполнения. Перед выпуском команда разработчиков проверяет подсистему безопасности и сочетание версий контейнера среды выполнения. Обновление между основными или дополнительными выпусками продукта:

  1. На устройстве остановите IoT Edge с помощью команды sudo iotedge system stop и uninstall.

  2. На устройстве обновите подсистему контейнеров Docker или Moby.

  3. На устройстве установите IoT Edge.

    Если вы импортируете старую конфигурацию с помощью iotedge config import, измените изображение [agent.config] созданного /etc/aziot/config.toml файла, чтобы использовать образ 1.5 для edgeAgent.

    Для получения дополнительных сведений см. раздел Настройка параметров устройства IoT Edge.

  4. В Центр Интернета вещей обновите развертывание модуля, чтобы ссылаться на новейшие системные модули.

  5. На устройстве запустите IoT Edge с помощью sudo iotedge config apply.

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

Обновление подсистемы безопасности

Подсистема безопасности IoT Edge включает набор собственных компонентов, которые необходимо обновить с помощью диспетчера пакетов на устройстве IoT Edge.

Проверьте версию подсистемы безопасности, запущенной на устройстве, с помощью команды iotedge version. Если вы используете IoT Edge для Linux в Windows, необходимо выполнить SSH на виртуальной машине Linux, чтобы проверить версию.

На устройствах Linux x64 используйте apt-get или соответствующий диспетчер пакетов для обновления подсистемы безопасности до последней версии.

Обновление apt:

sudo apt-get update

Примечание.

Инструкции по получению последней конфигурации репозитория из Майкрософт см. в предварительных шагах по Install IoT Edge.

Проверьте, какие версии IoT Edge доступны:

apt list -a aziot-edge

Обновление IoT Edge:

sudo apt-get install aziot-edge

При запуске apt-get install aziot-edge выполняется обновление подсистемы безопасности и устанавливается служба удостоверений в aziot-identity-service качестве обязательной зависимости.

Затем повторно примените конфигурацию, чтобы убедиться, что система полностью обновлена.

sudo iotedge config apply

Обновление контейнеров среды выполнения

Способ обновления агента IoT Edge и контейнеров концентратора IoT Edge зависит от того, используются ли в вашем развертывании скользящие теги (например, 1.5) или конкретные теги (например, 1.5.1).

Проверьте версию агента IoT Edge и модулей концентратора IoT Edge на устройстве с помощью команд iotedge logs edgeAgent или iotedge logs edgeHub. Если вы используете IoT Edge для Linux в Windows, необходимо выполнить SSH на виртуальной машине Linux, чтобы проверить версии модуля среды выполнения.

Снимок экрана: где найти версию контейнера в журналах консоли.

Общие сведения о тегах IoT Edge

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

  • Последовательные теги: используются только первые два значения номера версии для получения последнего образа, соответствующего этим цифрам. Например, 1.5 обновляется всякий раз, когда существует новый выпуск, указывающий на последнюю версию 1.5.x. Если среда выполнения контейнера на устройстве IoT Edge снова извлекает образ, модули среды выполнения обновляются до последней версии. Развертывания на портале Azure по умолчанию используют последовательный метод. Используйте этот подход для целей разработки.

  • Конкретные теги: используются все три значения номера версии для явной установки версии образа. Например, 1.5.0 не изменяется после первоначального выпуска. Вы можете объявить новый номер версии в манифесте развертывания, когда будете готовы к обновлению. Используйте этот подход для производственных целей.

Обновление изображения динамически изменяющегося тега

Если вы используете скользящие теги в развертывании (например, mcr.microsoft.com/azureiotedge-hub:**1.5**), необходимо заставить среду выполнения контейнера на вашем устройстве скачать обновленную версию образа.

Удалите локальную версию образа с устройства IoT Edge. На Windows компьютерах удаление подсистемы безопасности также удаляет образы среды выполнения, поэтому вам не нужно снова выполнять этот шаг.

docker rmi mcr.microsoft.com/azureiotedge-hub:1.5
docker rmi mcr.microsoft.com/azureiotedge-agent:1.5

Для удаления изображений может потребоваться использовать флаг принудительного удаления -f.

Служба IoT Edge извлекает последние версии образов среды выполнения и автоматически запускает их на устройстве снова.

Обновление образа конкретного тега

При использовании определенных тегов в развертывании (например, mcr.microsoft.com/azureiotedge-hub:**1.5.1**) обновите тег в манифесте развертывания и примените изменения к устройству.

  1. В Центр Интернета вещей на портале Azure выберите устройство IoT Edge и выберите Set Modules.

  2. На вкладке "Модули" выберите "Параметры среды выполнения".

  3. В параметрах среды выполнения обновите значение URI изображения в разделе агента Edge с требуемой версией. Например, mcr.microsoft.com/azureiotedge-agent:1.5.1 не нажимайте кнопку "Применить ".

  4. Перейдите на вкладку Edge Hub и обновите значение URI изображения на ту же требуемую версию. Например: mcr.microsoft.com/azureiotedge-hub:1.5.1.

  5. Нажмите кнопку "Применить" , чтобы сохранить изменения.

  6. Выберите "Просмотр и создание", просмотрите развертывание, как показано в JSON-файле, и нажмите кнопку "Создать".

Обновление URI модуля партнера

При использовании партнерских модулей обновите развертывания модулей, используя URI образов, предоставляемых партнером. Чтобы получить обновленный URI образа контейнера, обратитесь к издателю модуля IoT Edge. Обновите конфигурации устройства с помощью нового URI образа, предоставленного издателем.

  1. Войдите на портал Azure и перейдите к Центр Интернета вещей.
  2. На левой панели выберите "Устройства" в меню управления устройствами .
  3. Выберите IoT Edge устройство, использующее модуль партнера из списка.
  4. На верхней панели выберите Настройка модулей.
  5. Выберите партнерский модуль IoT Edge, который вы хотите обновить, указав новый URI для образа.
  6. Обновите значение URI образа с помощью нового URI образа , предоставленного издателем.
  7. Нажмите кнопку "Применить" , чтобы сохранить изменения.
  8. Выберите "Просмотр и создание", просмотрите развертывание, как показано в JSON-файле, и нажмите кнопку "Создать".

Проверка соответствия версий

  1. На устройстве используйте iotedge version для проверки версии подсистемы безопасности. Выходные данные включают основные, незначительные и исправительные номера версий. Например, iotedge 1.5.13.

  2. В параметрах среды выполнения развертывания устройства убедитесь, что версии URI образов edgeHub и edgeAgent совпадают с основной и дополнительной версиями подсистемы безопасности. Если версия подсистемы безопасности — 1.5.15, версия образа — 1.5. Например, mcr.microsoft.com/azureiotedge-hub:1.5 и mcr.microsoft.com/azureiotedge-agent:1.5.

Примечание.

Обновите подсистему безопасности IoT Edge и контейнеры среды выполнения до той же поддерживаемой версии выпуска. Хотя поддерживаются несовпадные версии, Майкрософт не тестировали все сочетания версий.

Чтобы узнать последнюю версию Azure IoT Edge, см. в релизах Azure IoT Edge.

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

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

  • Запустите устранение неполадок с помощью команды check . Он запускает коллекцию тестов конфигурации и подключения для распространенных проблем.

    sudo iotedge check --verbose

  • Чтобы просмотреть состояние системы IoT Edge, выполните следующую команду:

    sudo iotedge system status

  • Чтобы просмотреть журналы компонентов узла, выполните следующую команду:

    sudo iotedge system logs

  • Чтобы проверить наличие повторяющихся проблем, сообщаемых edgeAgent и edgeHub, выполните следующую команду:

    Обязательно замените <module> собственным именем модуля. Если нет проблем, выходные данные не отображаются.

    sudo iotedge logs <module>

Дополнительные сведения см. в разделе Устранение неполадок устройства IoT Edge.

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

Просмотрите последние выпуски Azure IoT Edge.

  • Last updated on