Обновление 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. IoT Edge 1.4 LTS заканчивается жизнью 12 ноября 2024 года.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    Если вы импортируете старую конфигурацию с помощью iotedge config import, измените образ [agent.config] созданного /etc/aziot/config.toml файла, чтобы использовать образ 1.4 для 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

Примечание.

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

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

apt list -a aziot-edge

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

sudo apt-get install aziot-edge defender-iot-micro-agent-edge

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

Рекомендуется установить микроагент с агентом Edge, чтобы обеспечить мониторинг безопасности и защиту устройств Edge. Дополнительные сведения о Microsoft Defender для Интернета вещей см. в статье "Что такое Microsoft Defender для Интернета вещей для разработчиков устройств".

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

sudo iotedge config apply

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

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

Проверьте версию модулей агента и центра 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

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

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

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

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

  1. В центре Интернета вещей на портале Microsoft Azure выберите свое устройство IoT Edge и нажмите Set Modules (Настройка модулей).

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

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

  4. Перейдите на вкладку "Пограничный концентратор" и обновите значение URI изображения с той же требуемой версией. Например, mcr.microsoft.com/azureiotedge-hub:1.5.

  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.4.2.

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

Примечание.

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

Последнюю версию Azure IoT Edge можно найти на сайте GitHub.

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

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

  • Запустите устранение неполадок с помощью команды 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 на сайте GitHub.

Будьте в курсе последних обновлений и объявлений, просматривая блог, посвященный “Интернету вещей”.