Руководство по преобразованию данных с помощью ППВМ Azure Stack Edge Pro для процесса расширенного развертывания

Внимание

Поддержка устройств ППВМ Azure Stack Edge Pro будет прекращена в феврале 2024 г. Если вы рассматриваете новые развертывания, рекомендуется изучить устройства Azure Stack Edge Pro 2 или Azure Stack Edge Pro с GPU для рабочих нагрузок.

В этом учебнике описывается, как настроить роль вычислений для процесса расширенного развертывания в устройстве ППВМ Azure Stack Edge Pro. Когда роль вычислений будет настроена, ППВМ Azure Stack Edge Pro может преобразовывать данные перед их отправкой в ​​Azure.

Вычисления можно настроить для процесса простого или расширенного развертывания в устройстве.

Критерии Простое развертывание Расширенное развертывание
Предполагаемое использование Администраторы ИТ Разработчики
Тип Использование службы Azure Stack Edge для развертывания модулей Использование службы Центр Интернета вещей для развертывания модулей
Развернутые модули Одна Цепочка или несколько модулей

Эта процедура может занять от 20 до 30 минут.

В этом руководстве описано следующее:

  • Настройка вычислений
  • добавление общих папок;
  • Добавление триггера
  • Добавление модуля вычислений.
  • Проверка преобразования и передачи данных

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

Прежде чем вы настроите роль вычислений на устройстве ППВМ Azure Stack Edge Pro, убедитесь в следующем.

Настройка вычислений

Чтобы настроить вычисления в ППВМ Azure Stack Edge Pro, необходимо создать ресурс Центра Интернета вещей.

  1. На портале Azure своего ресурса Azure Stack Edge перейдите к разделу Обзор. В области справа выберите плитку IoT Edge.

    Get started with compute

  2. На плитке Enable IoT Edge service (Включение службы IoT Edge) выберите элемент Добавить. Будет активирована служба IoT Edge, которая позволяет локально развертывать модули IoT Edge на устройстве.

    Get started with compute 2

  3. В разделе Create IoT Edge service (Создать службу IoT Edge) введите следующее:

    Поле значение
    Отток подписок Выберите подписку для своего ресурса Центра Интернета вещей. Вы можете выбрать ту же подписку, которую использует ресурс Azure Stack Edge.
    Группа ресурсов Введите имя группы ресурсов для своего ресурса Центра Интернета вещей. Вы можете выбрать ту же группу ресурсов, которую использует ресурс Azure Stack Edge.
    Центр Интернета вещей Выберите Новый или Существующий.
    По умолчанию для создания ресурса Интернета вещей используется уровень служб "Стандартный" (S1). Чтобы использовать ресурс Интернета вещей уровня служб "Бесплатный", создайте его и выберите существующий ресурс.
    Имя. Оставьте значение по умолчанию или введите имя для своего ресурса Центра Интернета вещей.

    Get started with compute 3

  4. Выберите Review + Create (Просмотреть и создать). Для создания ресурса Центра Интернета вещей нужно несколько минут. После создания ресурса Центра Интернета вещей сведения в разделе Обзор обновятся. Там будет указано, что служба IoT Edge запущена.

    При настройке службы IoT Edge на пограничном устройстве создается два устройства — устройство Интернета вещей и устройство IoT Edge. Оба устройства можно просмотреть в ресурсе Центра Интернета вещей. На этом устройстве IoT Edge также запущена среда выполнения IoT Edge. На данный момент доступна только платформа Linux для устройства IoT Edge.

    Чтобы убедиться, что роль вычислений Edge настроена, выберите свойства службы > IoT Edge и просмотрите устройство Интернета вещей и устройство IoT Edge.

    Get started with compute 4

добавление общих папок;

Для расширенного развертывания, описанного в этом учебнике, вам понадобятся две общие папки: общая папка Edge и еще одна локальная общая папка Edge.

  1. Добавьте общую папку Edge на устройство следующим образом:

    1. В ресурсе Azure Stack Edge перейдите к общим папкам IoT Edge>.

    2. На странице Общие папки на панели команд выберите элемент + Добавить общую папку.

    3. В колонке Добавление общего файлового ресурса укажите имя общей папки и выберите ее тип.

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

    5. Выберите учетную запись хранения, службу хранилища, существующего пользователя, а затем щелкните Создать.

      Add an Edge share

    После создания общей папки Edge вы получите уведомление об успешном создании. Список общих папок обновляется с учетом новых.

  2. Добавьте локальную общую папку Edge на устройство Edge. Для этого повторите все шаги, описанные на предыдущем этапе, и установите флажок Настройка в качестве локальной общей папки Edge. Данные из локальной обшей папки остаются на устройстве.

    Add an Edge local share

  3. В колонке Общие папки вы увидите обновленный список общих папок.

    Updated list of shares

  4. Выберите из списка созданную локальную общую папку, чтобы просмотреть ее свойства. Скопируйте значение, соответствующее этому ресурсу, в поле Локальная точка подключения для модулей пограничных вычислений.

    Эта локальная точка подключения используется при развертывании модуля.

    The

  5. Выберите из списка созданную общую папку Edge, чтобы просмотреть ее свойства. Скопируйте значение, соответствующее этому ресурсу, в поле Локальная точка подключения для модулей пограничных вычислений.

    Эта локальная точка подключения используется при развертывании модуля.

    Add custom module

Добавление триггера

  1. Перейдите к ресурсу Azure Stack Edge и перейдите к триггерам IoT Edge>. Выберите + Добавить триггер.

    Add trigger

  2. В колонке Добавить триггер введите следующие значения.

    Поле значение
    Имя триггера Уникальное имя триггера.
    Тип триггера Выберите триггер файла. Триггер файла срабатывает, когда возникает событие файла, например файл записывается во входную общую папку. С другой стороны, запланированный триггер срабатывает в соответствии с определенным вами расписанием. В этом примере нам нужен триггер файла.
    Входная общая папка Выберите входную общую папку. В этом случае входной общей папкой будет локальная общая папка Edge. Используемый здесь модуль позволяет переместить файлы из локальной общей папки Edge в общую папку Edge, из которой они передаются в облако.

    Add trigger 2

  3. После создания триггера вы получите уведомление. Список триггеров обновляется, чтобы отобразить только что созданный триггер. Выберите только что созданный триггер.

    Add trigger 3

  4. Скопируйте и сохраните пример маршрута. Вам предстоит изменить этот пример маршрута и использовать его позже в Центре Интернета вещей.

    "sampleroute": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/modulename/inputs/input1\")"

    Add trigger 4

Добавление модуля

На этом устройстве Edge нет пользовательских модулей. Можно добавить пользовательский или готовый модуль. Чтобы узнать, как создать пользовательский модуль, ознакомьтесь со статьей Разработка на C# модуля для устройства ППВМ Azure Stack Edge Pro.

В этом разделе объясняется, как добавить пользовательский модуль к устройству IoT Edge, которое было создано с помощью руководства Разработка на C# модуля для ППВМ Azure Stack Edge Pro. Этот пользовательский модуль позволяет получить файлы из локальной общей папки Edge на устройстве Edge и перенести их в облачную общую папку Edge на устройстве. Затем облачный ресурс переносит файлы в учетную запись Azure, связанную с облачным ресурсом.

  1. Перейдите к ресурсу Azure Stack Edge и перейдите к обзору IoT Edge>. На плитке Модули выберите элемент Go to Azure IoT Hub (Перейти к Центру Интернета вещей Azure).

    Select advanced deployment

  1. В ресурсе Центра Интернета вещей перейдите к устройству IoT Edge, а затем выберите устройство IoT Edge.

    Go to IoT Edge device in IoT Hub

  2. В разделе Сведения об устройстве выберите Задание модулей.

    The Set Modules link

  3. В разделе Добавить модули выполните следующее:

    1. Введите имя, адрес, имя пользователя и пароль для параметров реестра контейнеров для настраиваемого модуля. Имя, адрес и перечисленные учетные данные используются для извлечения модулей с соответствующим URL-адресом. Чтобы развернуть этот модуль, в разделе Модули развертывания выберите Модуль IoT Edge. Этот модуль IoT Edge является контейнером Docker, который можно развернуть на устройстве IoT Edge, связанном с вашим устройством ППВМ Azure Stack Edge Pro.

      The Set Modules page

    2. Укажите настройки для настраиваемого модуля IoT Edge. Введите следующие значения.

      Поле Значение
      Имя. Уникальное имя модуля. Этот модуль является контейнером Docker, который можно развернуть на устройстве IoT Edge, связанном с вашим устройством ППВМ Azure Stack Edge Pro.
      URI образа URI образа для соответствующего образа контейнера для модуля.
      Требуются учетные данные Если установлен этот флажок, для получения модулей с соответствующим URL-адресом используются имя пользователя и пароль.

      В поле Параметры создания контейнера введите локальные точки подключения для модулей Edge, которые вы скопировали на предыдущих шагах для общей папки Edge и локальной общей папки Edge.

      Внимание

      Пути, используемые здесь, вставляются в контейнер, поэтому они должны соответствовать тому, какие ожидаются функциональные возможности в контейнере. Если вы создаете пользовательский модуль, в код, указанный в этом модуле, нужно ввести скопированные пути. Не изменяйте эти пути.

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

      {
        "HostConfig": 
        {
         "Binds": 
          [
           "/home/hcsshares/mydbesmbedgelocalshare1:/home/input",
           "/home/hcsshares/mydbesmbedgeshare1:/home/output"
          ]
         }
      }
      

      Укажите все переменные среды, используемые в вашем модуле. Переменные среды предоставляют дополнительные сведения, которые помогают определить среду, где выполняется модуль.

      The Container Create Options box

    3. При необходимости настройте расширенные параметры Edge, а затем нажмите кнопку Далее.

      Add custom module 2

  4. В разделе Укажите маршруты настройте маршруты между модулями.

    The Specify Routes

    Маршрут можно заменить следующей строкой маршрута, скопированной ранее. В этом случае введите имя локального общего ресурса, который будет отправлять данные в облачный общий ресурс. Замените modulename именем модуля. Выберите Далее.

    "route": "FROM /* WHERE topic = 'mydbesmbedgelocalshare1' INTO BrokeredEndpoint(\"/modules/filemove/inputs/input1\")"
    

    The Specify Routes section

  5. В разделе Проверка развертывания просмотрите все параметры, а затем выберите Отправить, чтобы отправить модуль для развертывания.

    The Set Modules page 2

    Это действие запускает развертывание модуля. После завершения развертывания состояние среды выполнения модуля изменится на Запущен.

    Add custom module 3

Проверка преобразования и передачи данных

Последний шаг — убедиться, что модуль подключен и работает как ожидалось. Состояние выполнения модуля должно быть "Работает" для вашего устройства IoT Edge в ресурсе Центра Интернета вещей.

Для проверки преобразования и передачи данных в Azure сделайте следующее.

  1. С помощью проводника подключитесь к локальным и облачным общим папкам Edge, созданным ранее.

    Verify data transform

  2. Добавьте данные в локальную общую папку.

    Verify data transform 2

    Данные переносятся в облачную общую папку.

    Verify data transform 3

    Затем данные переносятся из облачного ресурса в учетную запись хранения. Для просмотра данных перейдите в свою учетную запись хранения и выберите Обозреватель службы хранилища Azure. Вы можете просмотреть отправленные данные в своей учетной записи хранения.

    Verify data transform 4

Вы завершили процесс проверки.

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

Из этого руководства вы узнали, как:

  • Настройка вычислений
  • добавление общих папок;
  • Добавление триггера
  • Добавление модуля вычислений.
  • Проверка преобразования и передачи данных

Сведения об администрировании устройства ППВМ Azure Stack Edge Pro см. в следующей статье.