Поделиться через


Краткое руководство. Использование Сетка событий Azure для маршрутизации событий хранилища BLOB-объектов в веб-конечную точку (портал Azure)

Сетка событий — это полностью управляемая служба, которая позволяет легко управлять событиями во множестве разных сервисов и приложений Azure. Она упрощает создание приложений, управляемых событиями, и бессерверных приложений. Общие сведения о службе см. в статье Обзор Сетки событий Azure.

Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начинать работу.

По завершении вы увидите, что данные события отправляются в веб-приложение.

Снимок экрана: пример приложения Сетка событий Azure Viewer с событием.

Создание учетной записи хранилища

  1. Войдите на портал Azure.

  2. Чтобы создать хранилище BLOB-объектов, выберите Создать ресурс.

  3. В поле поискавведите Учетная запись храненияи выберите Учетная запись хранения из списка результатов.

    Снимок экрана: поиск по запросу

  4. На странице Учетная запись хранения выберите Создать, чтобы начать создание учетной записи. Чтобы подписаться на события, создайте учетную запись хранения общего назначения версии 2 или учетную запись хранения BLOB-объектов.

  5. На странице Создание учетной записи хранения выполните следующие действия:

    1. Выберите свою подписку Azure.

    2. Группа ресурсов — создайте группу ресурсов Azure или выберите существующую.

    3. Введите имя учетной записи хранения.

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

    5. Для основной службы выберите Хранилище BLOB-объектов Azure или Azure Data Lake Storage 2-го поколения.

    6. Для параметра Избыточность выберите в раскрывающемся списке Локально избыточное хранилище (LRS).

    7. В нижней части страницы выберите Review + create (Проверить и создать).

      Снимок экрана: страница создания учетной записи хранения.

    8. На вкладке "Просмотр и создание" просмотрите параметры и нажмите кнопку "Создать".

      Примечание.

      Интеграцию событий поддерживают только учетные записи хранения типа StorageV2 (версия 2, общего назначения) и BlobStorage. Учетные записи хранения типа Storage (general purpose v1) не поддерживают интеграцию с Сеткой событий.

  6. Развертывание занимает несколько минут. На странице развертывания выберите "Перейти к ресурсу".

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

  7. На странице учетной записи хранения выберите События в меню слева.

    Снимок экрана: страница

  8. Сохраните эту страницу в веб-браузере.

Создание конечной точки сообщения

Перед созданием подписки на события хранилища BLOB-объектов необходимо создать конечную точку для сообщения о событии. Обычно конечная точка выполняет действия на основе данных событий. Чтобы упростить это краткое руководство, вы развернете предварительно созданное веб-приложение , отображающее сообщения о событиях. Развернутое решение содержит план службы приложений, веб-приложение службы приложений и исходный код из GitHub.

  1. Выберите Развернуть в Azure, чтобы развернуть решение в своей подписке.

    Кнопка для развертывания шаблона Resource Manager в Azure.

  2. На странице Настраиваемое развертывание выполните следующие действия:

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

    2. В поле Имя сайта введите имя веб-приложения.

    3. В поле Имя плана размещения введите имя плана службы приложений для размещения веб-приложения.

    4. Выберите Review + create (Просмотреть и создать).

      Снимок экрана: страница настраиваемого развертывания.

  3. На странице Отзыв и создание выберите Создать.

  4. Развертывание занимает несколько минут. На странице развертывания выберите "Перейти к группе ресурсов".

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

  5. На странице Группа ресурсов в списке ресурсов выберите созданное вами веб-приложение. В списке вы также увидите план службы приложений и учетную запись хранения.

    Снимок экрана: выбор веб-приложения в группе ресурсов.

  6. На странице Служба приложений для веб-приложения выберите URL-адрес для перехода на веб-сайт. URL-адрес должен иметь следующий формат: https://<your-site-name>.azurewebsites.net.

    Снимок экрана: выбор ссылки для перехода к веб-приложению.

  7. Убедитесь, что вы видите сайт, но события еще не размещены на нем.

    Просмотрите новый сайт.

    Внимание

    Держите окно средства просмотра Сетки событий Azure открытым, чтобы вы могли видеть события по мере их публикации.

Создание подписки на хранилище BLOB-объектов

Подпишитесь на раздел, чтобы определить в сетке событий Azure, какие из них необходимо отслеживать и куда их отправлять.

  1. Если вы закрыли страницу учетной записи хранения, перейдите к созданной ранее учетной записи служба хранилища Azure. В меню слева нажмите Все ресурсы и выберите нужную учетную запись хранения.

  2. На странице учетной записи хранения выберите События в меню слева.

  3. Выберите Дополнительные параметры и Веб-перехватчик. Вы отправляете события в приложение средства просмотра с помощью веб-перехватчика для конечной точки.

    Снимок экрана: выбор веб-перехватчика на странице

  4. На странице Создание подписки на события сделайте следующее:

    1. Укажите имя для подписки на событие.

    2. Введите имя системного раздела. См. общие сведения о системных разделах.

    3. Убедитесь, что для типа конечной точки задано значение Web Hook.

      Снимок экрана: страница

  5. Для конечной точки выберите "Настроить конечную точку" и введите URL-адрес веб-приложения и добавьте api/updates его в URL-адрес домашней страницы (например: https://spegridsite.azurewebsites.net/api/updates), а затем нажмите кнопку "Подтвердить выбор".

    Снимок экрана: страница выбора веб-перехватчика.

  6. Теперь на странице Создать подписку на события нажмите кнопку Создать, чтобы создать подписку на события.

    Снимок экрана: страница

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

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

Теперь необходимо активировать событие, чтобы увидеть, как Сетка событий Azure распределяет сообщение к вашей конечной точке.

Отправка события в конечную точку

Событие для хранилища BLOB-объектов активируется при отправке файла. Определенное содержимое для файла не требуется.

  1. На портале Microsoft Azure перейдите в свою учетную запись хранения больших двоичных объектов и выберите Контейнеры в меню слева.

  2. Выберите + Container (+ Контейнер). Присвойте контейнеру имя и любой уровень доступа, после чего щелкните Создать.

    Снимок экрана: страница

  3. Выберите новый контейнер.

    Снимок экрана: выбор контейнера.

  4. Чтобы отправить файл, выберите Отправить. На странице Отправить BLOB-объект найдите и выберите файл, который нужно передать для тестирования, а затем нажмите кнопку Отправить.

    Снимок экрана: страница

  5. Перейдите к тестовому файлу и отправьте его.

  6. Вы активировали событие, а сетка событий отправила сообщение в конечную точку, настроенную при подписке. Сообщение имеет формат JSON и содержит массив с одним или несколькими событиями. В следующем примере сообщение JSON содержит массив с одним событием. Просмотрите веб-приложение. Вы увидите полученное событие создания большого двоичного объекта.

    Снимок экрана: страница просмотра сетки событий с событием создания BLOB-объектов.

Очистка ресурсов

Если вы планируете продолжить работу с этим событием, не удаляйте ресурсы, созданные при работе с этой статьей. В противном случае удалите ресурсы, созданные при работе с этой статьей.

Выберите группу ресурсов и щелкните Удалить группу ресурсов.

Теперь, когда вы знаете, как создавать пользовательские раздели и подписки на события, ознакомьтесь с дополнительными сведениями о сетке событий, которые могут помочь вам: