Развертывание модулей IoT Edge Azure с помощью портала Azure

Область применения: IoT Edge 1.5 IoT Edge 1.4

Внимание

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

Внимание

Начиная с 28 августа 2024 г. Azure Marketplace обновляет модель распространения для модулей IoT Edge. Партнеры (издатели модулей) начнут размещать свои модули IoT Edge в реестрах контейнеров, принадлежащих издателям. Образы модулей IoT Edge не будут доступны для скачивания из реестра контейнеров Azure Marketplace.

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

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

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

В этой статье описано, как с помощью портала Azure создать манифест развертывания и отправить это развертывание на устройство IoT Edge. Информацию о создании развертываний, предназначенных для нескольких устройств с определенными значениями тегов, см. в разделе Развертывание и мониторинг модулей IoT Edge в нужном масштабе (предварительная версия).

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

• Центр Интернета вещей в подписке Azure.

• Устройство IoT Edge.

  Если устройство IoT Edge не настроено, его можно создать на виртуальной машине Azure. Выполните действия, описанные в одном из кратких руководств, чтобы создать виртуальное устройство Linux или создать виртуальное устройство Windows.

Настройка манифеста развертывания

Манифест развертывания — это документ JSON, в котором определены развертываемые модули, способ передачи данных между этими модулями и требуемые свойства для двойников модулей. Дополнительные сведения о работе манифестов развертывания и об их создании см. в руководстве по использованию, настройке и повторном использовании модулей Azure IoT Edge.

Портал Azure предоставляет мастер, который в пошаговом режиме помогает создать манифест развертывания без необходимости редактировать документ JSON вручную. В этом мастере есть три шага: Добавление модулей, Указание маршрутов и Просмотр развертываний.

Примечание.

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

При развертывании на устройстве под управлением версии 1.0.9 или более ранней измените Параметры среды выполнения на шаге Модули мастера для схемы версии 1.0.

Выбор устройства и добавление модулей

1. Войдите на портал Azure и перейдите к своему Центру Интернета вещей.

2. На левой панели выберите "Устройства" в меню управления устройствами .

3. Выберите целевое устройство IoT Edge из списка.

4. На верхней панели выберите Задание модулей.

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

6. В разделе Модули IoT Edge на этой странице выберите Добавить.

   

7. Выберите тип модулей, которые нужно добавить в раскрывающемся меню. Вы можете добавить модули IoT Edge или модули Azure Stream Analytics.

модуль IoT Edge

Используйте этот параметр, чтобы добавить модули Майкрософт, партнерские модули или пользовательские модули. Укажите имя модуля и URI образа контейнера. URI образа контейнера — это расположение образа модуля в реестре контейнеров. Список образов модулей Microsoft IoT Edge см. в Реестр артефактов Microsoft. Чтобы получить универсальный код ресурса (URI) образа контейнера, обратитесь к издателю модуля IoT Edge.

Например, чтобы добавить модуль датчика температуры, имитированный корпорацией Майкрософт:

1. Введите следующие параметры:

   Параметр	Значение
   URI образа	mcr.microsoft.com/azureiotedge-simulated-temperature-sensor
   Политика перезапуска	всегда
   Требуемое состояние	выполняется

   

2. Выберите Добавить.

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

   

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

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

Модуль Azure Stream Analytics

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

1. Выберите свою подписку и созданное задание Edge Azure Stream Analytics.
2. Выберите Сохранить.

Дополнительные сведения о развертывании Azure Stream Analytics в модуле IoT Edge см. в руководстве по развертыванию Azure Stream Analytics в качестве модуля IoT Edge.

Настройка маршрутов

На вкладке Маршруты определите способ передачи сообщений между модулями и Центром Интернета вещей. Сообщения создаются с использованием пар "имя — значение". По умолчанию первое развертывание для нового устройства включает маршрут с именем route и определяется как FROM /messages/* INTO $upstream, что означает, что все сообщения, выходные данные любого модуля отправляются в Центр Интернета вещей.

Параметры Приоритет и Срок жизни — необязательные параметры, которые можно включить в определение маршрута. Параметр "Приоритет" позволяет выбрать маршруты, которые должны обрабатываться в первую очередь, или маршруты, которые должны быть обработаны последними. Приоритет определяется присвоением значения в пределах 0–9, где 0 — наивысший приоритет. Параметр "Срок жизни" позволяет объявлять, как долго должны удерживаться сообщения в этом маршруте, пока не будут обработаны или удалены из очереди.

Дополнительные сведения о создании маршрутов см. в разделе Объявление маршрутов.

После настройки маршрутов щелкните Далее: Проверка и создание, чтобы перейти к следующему шагу мастера.

Проверка развертывания

В разделе обзорной информации вы увидите манифест развертывания в формате JSON, который был создан на основе параметров, выбранных вами в двух предыдущих разделах. Обратите внимание, что здесь объявлены два дополнительных модуля, которые вы не добавляли: $edgeAgent и $edgeHub. Эти два модуля составляют среду выполнения IoT Edge и являются обязательными для каждого развертывания.

Просмотрите сведения о развертывании, а затем нажмите Создать.

Просмотр модулей, установленных на устройстве

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

Последовательно выберите Далее: Маршруты и продолжайте развертывание, как описано в разделах Настройка маршрутов и Проверка развертывания ранее в этой статье.

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

Узнайте, как развертывать и отслеживать модули IoT Edge в масштабе.