Развертывание модулей Azure IoT Edge из Visual Studio Code
Область применения:
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.
Создав модули IoT Edge с в соответствии с определенной бизнес-логикой, вы наверняка захотите развернуть их на устройствах, которые будут работать в граничной среде. Если у вас есть несколько модулей, которые работают вместе для сбора и обработки данных, вы можете развернуть их одновременно и объявить правила маршрутизации, которые их соединяют.
В этой статье показано, как создать манифест развертывания JSON и применить этот файл для отправки этого развертывания на устройство IoT Edge. Информацию о создании развертываний, предназначенных для нескольких устройств с определенными значениями тегов, см. в статье Развертывание модулей IoT Edge в требуемом масштабе с помощью Visual Studio Code.
Необходимые компоненты
Центр Интернета вещей в подписке Azure.
Устройство IoT Edge.
Если устройство IoT Edge не настроено, его можно создать на виртуальной машине Azure. Выполните действия, описанные в одном из кратких руководств, чтобы создать виртуальное устройство Linux или создать виртуальное устройство Windows.
Azure IoT Edge для Visual Studio Code. Средства Azure IoT Edge для расширения Visual Studio Code в режиме обслуживания.
Настройка манифеста развертывания
Манифест развертывания — это документ JSON, в котором определены развертываемые модули, способ передачи данных между этими модулями и требуемые свойства для двойников модулей. Дополнительные сведения о работе манифестов развертывания и об их создании см. в руководстве по использованию, настройке и повторном использовании модулей Azure IoT Edge.
Чтобы развернуть модули с помощью Visual Studio Code, сохраните манифест развертывания на локальный компьютер в формате JSON. В следующем разделе вам потребуется путь к файлу для запуска команды, применяющей конкретную конфигурацию к устройству.
Вот пример простого манифеста развертывания с одним модулем.
Примечание.
Этот пример манифеста развертывания использует схему версии 1.1 для агента IoT Edge и центра. Версия схемы 1.1 была выпущена вместе с IoT Edge версии 1.0.10. Она включает такие функции, как определение порядка запуска модуля и приоритизация маршрутов.
{
"modulesContent": {
"$edgeAgent": {
"properties.desired": {
"schemaVersion": "1.1",
"runtime": {
"type": "docker",
"settings": {
"minDockerVersion": "v1.25",
"loggingOptions": "",
"registryCredentials": {}
}
},
"systemModules": {
"edgeAgent": {
"type": "docker",
"settings": {
"image": "mcr.microsoft.com/azureiotedge-agent:1.5",
"createOptions": "{}"
}
},
"edgeHub": {
"type": "docker",
"status": "running",
"restartPolicy": "always",
"settings": {
"image": "mcr.microsoft.com/azureiotedge-hub:1.5",
"createOptions": "{\"HostConfig\":{\"PortBindings\":{\"443/tcp\":[{\"HostPort\":\"443\"}],\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}]}}}"
}
}
},
"modules": {
"SimulatedTemperatureSensor": {
"version": "1.5",
"type": "docker",
"status": "running",
"restartPolicy": "always",
"settings": {
"image": "mcr.microsoft.com/azureiotedge-simulated-temperature-sensor:1.5",
"createOptions": "{}"
}
}
}
}
},
"$edgeHub": {
"properties.desired": {
"schemaVersion": "1.1",
"routes": {
"route": "FROM /messages/* INTO $upstream"
},
"storeAndForwardConfiguration": {
"timeToLiveSecs": 7200
}
}
},
"SimulatedTemperatureSensor": {
"properties.desired": {}
}
}
}
Вход в систему для получения доступа к Центру Интернета вещей
Для выполнения действий с Центром Интернета вещей можно использовать расширения Интернета вещей Azure для Visual Studio Code. Для этого войдите в учетную запись Azure и выберите Центр Интернета вещей, с которым вы хотите работать.
Откройте в Visual Studio Code представление Explorer.
В нижней части Explorer разверните раздел Центр Интернета вещей.
Щелкните значок ... в заголовке раздела Центр Интернета вещей. Если значок многоточия не отображается, наведите курсор на заголовок.
Щелкните Выбрать Центр Интернета вещей.
Если вы еще не вошли в учетную запись Azure, сделайте это сейчас, следуя инструкциям.
Выберите свою подписку Azure.
Выберите нужный Центр Интернета вещей.
Развертывание на устройстве
Для развертывания модулей на устройстве следует применить манифест развертывания, в который были заранее внесены сведения о модулях.
В обозревателе Visual Studio Code разверните раздел Центр Интернета вещей Azure, а затем раздел Устройства.
Щелкните правой кнопкой мыши на устройстве IoT Edge, которое необходимо настроить с помощью манифеста развертывания.
Совет
Чтобы подтвердить, что выбранное устройство является устройством IoT Edge, выберите его, после чего развернется список модулей, где можно проверить наличие $edgeHub и $edgeAgent. Каждое устройство IoT Edge содержит эти два модуля.
Выберите Create Deployment for Single Device (Создание развертывания для одного устройства).
Перейдите к файлу JSON манифеста развертывания, который необходимо использовать, и нажмите Выберите манифест развертывания Edge.
Результаты развертывания печатаются в выходных данных Visual Studio Code. Если целевое устройство запущено и подключено к Интернету, успешные развертывания применяются в течение нескольких минут.
Просмотр модулей, установленных на устройстве
Завершив развертывание модулей на устройстве, их можно просмотреть в разделе Центр Интернета вещей Azure. Выберите стрелку рядом с устройством IoT Edge, чтобы развернуть его. Отобразятся все модули, которые выполняются в настоящий момент.
Если вы недавно развернули новые модули на устройстве, наведите указатель мыши на заголовок раздела Azure IoT Hub Devices (Устройства Центра Интернета вещей Azure) и выберите значок обновления, чтобы обновить представление.
Щелкните правой кнопкой мыши на название модуля, чтобы его просмотреть и отредактировать.
Следующие шаги
Изучите раздел Развертывание и мониторинг модулей IoT Edge в требуемом масштабе с помощью Visual Studio Code