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

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

Важно!

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

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

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

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

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

Манифест развертывания — это документ 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. Предоставляется имя модуля и URI образа контейнера. Например, URI образа для примера модуля SimulatedTemperatureSensor представляет собой mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.0. Если образ модуля хранится в приватном реестре контейнеров, добавьте на этой странице учетные данные для доступа к образу.
    • Модуль Marketplace. Модули, размещенные в Azure Marketplace. Для некоторых модулей Marketplace требуется дополнительная настройка, поэтому ознакомьтесь со сведениями о модуле в списке Модули IOT Edge в Azure Marketplace.
    • Модуль Azure Stream Analytics. Для модулей, созданных из рабочей нагрузки Azure Stream Analytics.
  8. После добавления модуля выберите имя модуля из списка, чтобы открыть параметры модуля. При желании заполните необязательные поля.

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

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

  9. Повторите шаги 6–8 для всех дополнительных модулей этого развертывания.

  10. Нажмите Далее: Маршруты, чтобы перейти в раздел маршрутов.

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

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

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

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

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

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

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

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

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

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

Развертывание модулей из Azure Marketplace

Azure Marketplace — это интернет-магазин приложений и служб, где вы можете просматривать разнообразные корпоративные приложения и решения, сертифицированные и оптимизированные для работы в Azure, включая модули IoT Edge.

Вы можете развернуть модуль IoT Edge из Azure Marketplace и из Центра Интернета вещей.

Развертывание из Azure Marketplace

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

  1. Подтвердите условия использования и политику конфиденциальности поставщика, выбрав Продолжить. Вам может потребоваться указать контактные данные.
  2. Выберите свою подписку и Центр Интернета вещей, к которому подключено целевое устройство.
  3. Выберите Развертывание на устройстве.
  4. Введите имя устройства или выберите Найти устройство, чтобы просмотреть устройства, зарегистрированные в центре.
  5. Выберите Создать для продолжения стандартного процесса настройки манифеста развертывания, при желании включая добавление других модулей. Сведения новых модулей, например URI образа, параметры создания или требуемые свойства, предопределены, но их можно изменить.

Убедитесь, что модуль развернут в Центре Интернета вещей на портале Azure. Выберите свое устройство и щелкните Задание модулей. Модуль будет указан в разделе Модули IoT Edge.

Развертывание из центра Интернета вещей Azure

Вы можете быстро развернуть модуль из Azure Marketplace на устройстве в Центре Интернета вещей на портале Azure.

  1. Найдите нужный Центр Интернета вещей на портале Azure.
  2. На левой панели выберите "Устройства" в меню управления устройствами .
  3. Выберите устройство IoT Edge, на которое будет выполняться развертывание.
  4. На верхней панели выберите Задание модулей.
  5. В разделе Модули IoT Edge щелкните Добавить и в раскрывающемся меню выберите Модуль в Marketplace.

Screenshot showing how to add a module in I o T Hub.

Выберите модуль на странице модулей IoT Edge в Marketplace. Выбранный модуль автоматически настраивается для вашей подписки, группы ресурсов и устройства. Затем он появится в списке модулей IoT Edge. Для некоторых модулей может понадобиться дополнительная настройка.

Совет

Сведения о модулях IoT Edge из центра Интернета вещей Azure ограничены. В первую очередь узнать больше о модулях IoT Edge можно в Azure Marketplace.

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

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

Изучите раздел Развертывание и мониторинг модулей IoT Edge в нужном масштабе (предварительная версия)