Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Область применения: IoT Edge 1.5
Внимание
IoT Edge 1.5 LTS является поддерживаемым выпуском. IoT Edge 1.4 LTS заканчивается жизнью с 12 ноября 2024 года. Если вы используете более ранний выпуск, см. статью Обновление IoT Edge.
Внимание
Начиная с 28 августа 2024 г. Microsoft 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.
Необходимые компоненты
Центр Интернета вещей в подписке Azure.
Устройство IoT Edge.
Если устройство IoT Edge не настроено, его можно создать на виртуальной машине Azure. Выполните действия, описанные в одной из статей краткого руководства, чтобы создать виртуальное устройство Linux или создать виртуальное устройство Windows.
Настройка манифеста развертывания
Манифест развертывания — это документ JSON, в котором определены развертываемые модули, способ передачи данных между этими модулями и требуемые свойства для двойников модулей. Дополнительные сведения о работе манифестов развертывания и их создании см. в статье о развертывании модулей и установке маршрутов в IoT Edge.
Портал Azure предоставляет мастер, который в пошаговом режиме помогает создать манифест развертывания без необходимости редактировать документ JSON вручную. В этом мастере есть три шага: Добавление модулей, Указание маршрутов и Просмотр развертываний.
Примечание.
Действия, описанные в этой статье, соответствуют последней версии схемы агента и центра IoT Edge. Версия схемы 1.1 была выпущена вместе с IoT Edge версии 1.0.10 и включает такие функции, как порядок запуска модуля и определение приоритетов маршрутов.
Если вы развертываете на устройстве с версией 1.0.9 или более ранней, измените Настройки среды выполнения на шаге Модули мастера, чтобы использовать схему версии 1.0.
Выбор устройства и добавление модулей
Войдите на портал Azure и перейдите к своему Центру Интернета вещей.
На левой панели выберите "Устройства" в меню управления устройствами .
Выберите целевое устройство IoT Edge из списка.
На верхней панели выберите Задание модулей.
В разделе учетных данных реестра контейнеров на странице укажите учетные данные для доступа к реестрам контейнеров, содержащим образы модулей. Например, модули находятся в частном реестре контейнеров или используете реестр контейнеров партнеров, для которых требуется проверка подлинности.
В разделе Модули IoT Edge на этой странице выберите Добавить.
Выберите тип модулей, которые нужно добавить в раскрывающемся меню. Вы можете добавить модули IoT Edge или модули Azure Stream Analytics.
модуль IoT Edge
Используйте этот параметр, чтобы добавить модули Майкрософт, партнерские модули или пользовательские модули. Укажите имя модуля и URI образа контейнера. URI образа контейнера — это расположение образа модуля в реестре контейнеров. Список образов модулей Microsoft IoT Edge см. в Реестр артефактов Microsoft. Чтобы получить универсальный код ресурса (URI) образа контейнера, обратитесь к издателю модуля IoT Edge.
Например, чтобы добавить модуль датчика температуры, имитированный корпорацией Майкрософт:
Введите следующие параметры:
Параметр Значение URI образа mcr.microsoft.com/azureiotedge-simulated-temperature-sensor
Политика перезапуска всегда Требуемое состояние выполняется Выберите Добавить.
После добавления модуля выберите имя модуля из списка, чтобы открыть параметры модуля. При желании заполните необязательные поля.
Дополнительные сведения о доступных параметрах модуля см. в разделе Настройка модуля и управление им.
Дополнительные сведения о двойнику модуля см. в разделе "Определение или обновление требуемых свойств".
Модуль Azure Stream Analytics
Используйте этот параметр для модулей, созданных из рабочей нагрузки Azure Stream Analytics.
- Выберите свою подписку и созданное задание Edge Azure Stream Analytics.
- Выберите Сохранить.
Дополнительные сведения о развертывании Azure Stream Analytics в модуле IoT Edge см. в руководстве по развертыванию Azure Stream Analytics в качестве модуля IoT Edge.
Настройка маршрутов
На вкладке "Маршруты" вы определяете, как передаются сообщения между модулями и Центром Интернета вещей. Сообщения создаются с использованием пар "имя — значение". По умолчанию первое развертывание для нового устройства включает маршрут, называемый маршрутом и определенный как FROM /messages/* INTO $upstream, что означает, что все сообщения, выведенные любыми модулями, отправляются в ваш IoT-хаб.
Параметры Приоритет и Срок жизни — необязательные параметры, которые можно включить в определение маршрута. Параметр "Приоритет" позволяет выбрать маршруты, которые должны обрабатываться в первую очередь, или маршруты, которые должны быть обработаны последними. Приоритет определяется присвоением значения в пределах 0–9, где 0 — наивысший приоритет. Параметр "Срок жизни" позволяет объявлять, как долго должны удерживаться сообщения в этом маршруте, пока не будут обработаны или удалены из очереди.
Дополнительные сведения о создании маршрутов см. в разделе Объявление маршрутов.
После настройки маршрутов щелкните Далее: Проверка и создание, чтобы перейти к следующему шагу мастера.
Проверка развертывания
В разделе обзорной информации вы увидите манифест развертывания в формате JSON, который был создан на основе параметров, выбранных вами в двух предыдущих разделах. Существует два модуля, которые вы не добавили: $edgeAgent и $edgeHub. Эти два модуля составляют среду выполнения IoT Edge и являются обязательными для каждого развертывания.
Просмотрите сведения о развертывании, а затем нажмите Создать.
Просмотр модулей, установленных на устройстве
После развертывания модулей на устройстве вы можете просмотреть все их на странице сведений об устройстве центра Интернета вещей. На этой странице отображается имя каждого развернутого модуля и полезные сведения, такие как состояние развертывания и код выхода.
Нажмите кнопку Далее: маршруты и продолжить развертывание, как описано в разделе "Указание маршрутов " и "Проверка развертывания " ранее в этой статье.
Следующие шаги
Узнайте, как развернуть модули IoT Edge в масштабе с помощью портала Azure.