Управление манифестами развертывания IoT Edge в приложении IoT Central

Манифест развертывания позволяет указать модули, которые среда выполнения IoT Edge должна скачать и настроить. Устройство IoT Edge может скачать манифест развертывания при первом подключении к приложению IoT Central. В этой статье описывается управление манифестами развертывания в приложении IoT Central.

Дополнительные сведения об IoT Edge и IoT Central см. в статье Подключение устройств Azure IoT Edge к приложению Azure IoT Central.

Сведения об управлении манифестами развертывания с помощью REST API IoT Central см. в статье "Как использовать REST API IoT Central для управления манифестами развертывания".

Управление манифестами развертывания

Страница манифестов Edge позволяет управлять файлами конфигурации развертывания в вашем приложении. На этой странице можно:

  • Отправка или создание манифестов развертывания
  • Изменение существующих манифестов развертывания
  • Удаление манифестов развертывания

Отправка и создание манифестов развертывания

При создании нового манифеста развертывания можно отправить JSON-файл манифеста развертывания или начать с существующего манифеста:

  1. На странице манифестов Edge нажмите кнопку +Создать.

  2. Введите имя манифеста развертывания.

  3. Если ваше приложение использует организации, выберите организацию, чтобы связать с ней манифест развертывания.

  4. Найдите файл манифеста развертывания для загрузки или выберите существующий манифест развертывания в качестве отправной точки для нового файла. IoT Central проверяет все отправленные файлы.

    Снимок экрана: загруженный и проверенный манифест развертывания.

  5. Нажмите кнопку Далее. На странице "Проверка и завершение " отображаются сведения о манифесте развертывания и модулях, которые он определяет. Кроме того, можно просмотреть необработанный JSON.

  6. Нажмите кнопку "Создать". Страница манифестов Edge теперь содержит новый манифест развертывания.

Подсказка

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

Изменение источника JSON манифеста развертывания

Чтобы изменить манифест развертывания, отредактируйте JSON напрямую:

  1. Перейдите на страницу манифестов Edge.

  2. Выберите "Изменить JSON " в контекстном меню манифеста развертывания, который требуется изменить.

  3. Используйте редактор JSON для внесения необходимых изменений. Затем выберите Сохранить.

Замена содержимого манифеста развертывания

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

  1. Перейдите на страницу манифестов Edge.

  2. Выберите манифест развертывания, который вы хотите заменить.

  3. В диалоговом окне "Настройка" найдите новый файл манифеста развертывания для отправки или выбора существующего манифеста развертывания в качестве отправной точки. IoT Central проверяет все отправленные файлы.

  4. Нажмите кнопку Далее. На странице "Проверка и завершение " отображаются сведения о новом манифесте развертывания и модулях, которые он определяет. Кроме того, можно просмотреть необработанный JSON.

  5. Нажмите кнопку "Сохранить". Страница манифестов Edge теперь включает обновленный манифест развертывания.

Управление устройствами IoT Edge

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

Если вы добавляете устройство IoT Edge, которое не назначено шаблону устройства, диалоговое окно "Создание устройства " выглядит следующим образом:

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

Чтобы выбрать манифест развертывания для устройства, выполните следующие действия.

  1. Переключите устройство Azure IoT Edge на Да.

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

  3. Нажмите кнопку "Создать".

Если добавить устройство IoT Edge, назначенное шаблону устройства, диалоговое окно "Создание устройства " выглядит следующим образом:

Снимок экрана: добавление назначенного устройства в приложение.

Чтобы выбрать манифест развертывания для устройства, выполните следующие действия.

  1. Переключатель устройства Azure IoT Edge уже имеет значение "Да ", так как IoT Central распознает, что вы используете шаблон устройства IoT Edge.

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

  3. Нажмите кнопку "Создать".

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

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

Обновление манифеста развертывания, которое использует устройство

Вы можете управлять манифестом развертывания для существующего устройства:

Снимок экрана: параметры управления манифестом развертывания на устройстве.

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

Используйте Изменить манифест, чтобы внести изменения в манифест развертывания этого устройства. Изменения, внесенные здесь, не влияют на манифест развертывания на странице Edge manifests.

Jobs

Чтобы назначить или обновить манифест развертывания для нескольких устройств, используйте задание. Используйте задание типа "Изменить манифест развертывания по краю":

Снимок экрана, показывающий тип задания для манифеста развертывания.

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

Манифест развертывания определяет модули для запуска на устройстве и необязательные свойства , которые можно использовать для настройки модулей.

Если вы назначаете шаблон устройства устройству IoT Edge, может потребоваться определить модули и записываемые свойства в шаблоне устройства. Чтобы добавить модули и определения свойств в шаблон устройства:

  1. Перейдите на страницу "Сводка по модулям " шаблона устройства IoT Edge.
  2. Выберите "Импорт модулей" из манифеста.
  3. Выберите соответствующий манифест развертывания из списка.
  4. Выберите Импорт. IoT Central добавляет пользовательские модули, определенные в манифесте развертывания, в шаблон устройства. Имена модулей в шаблоне устройства соответствуют именам пользовательских модулей в манифесте развертывания. Созданный интерфейс включает определения свойств для свойств, определенных для пользовательского модуля в манифесте развертывания:

Снимок экрана: импорт определений модулей в шаблон устройства.