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

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

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

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

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

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

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

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

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

• Интерфейс командной строки Azure в вашей среде. Версия Azure CLI должна быть 2.0.70 или выше. Используется az --version для проверки. Эта версия поддерживает команды az extension и использует платформу команд Knack.

• Расширение Интернета вещей для Azure CLI

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

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

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

Ниже приведен базовый манифест развертывания с одним модулем в качестве примера:

{
  "content": {
    "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\":{\"5671/tcp\":[{\"HostPort\":\"5671\"}],\"8883/tcp\":[{\"HostPort\":\"8883\"}],\"443/tcp\":[{\"HostPort\":\"443\"}]}}}"
              }
            }
          },
          "modules": {
            "SimulatedTemperatureSensor": {
              "version": "1.0",
              "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": {
            "upstream": "FROM /messages/* INTO $upstream"
          },
          "storeAndForwardConfiguration": {
            "timeToLiveSecs": 7200
          }
        }
      },
      "SimulatedTemperatureSensor": {
        "properties.desired": {
          "SendData": true,
          "SendInterval": 5
        }
      }
    }
  }
}

Развертывание на устройстве

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

Измените каталоги в папку, в которой вы сохранили манифест развертывания. Если вы использовали один из шаблонов Visual Studio Code IoT Edge, используйте deployment.json файл в папке конфигурации каталога решения, а не deployment.template.json файла.

Следующая команда применяет конфигурацию к устройству IoT Edge:

az iot edge set-modules --device-id [device id] --hub-name [hub name] --content [file path]

В параметре идентификатора устройства учитывается регистр. Параметр content указывает на сохраненный ранее файл манифеста развертывания.

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

Завершив развертывание модулей на устройстве, вы можете просмотреть их список с помощью следующей команды:

Просмотрите модули на устройстве IoT Edge:

az iot hub module-identity list --device-id [device id] --hub-name [hub name]

В параметре идентификатора устройства учитывается регистр.

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

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