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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    5. Для предпочтительного типа хранилища выберите хранилище BLOB-объектов Azure или Azure Data Lake Storage 2-го поколения.

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

    7. Нажмите Review + create внизу страницы.

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

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

      Примечание.

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

  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-объектов

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

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

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

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

    Снимок экрана, показывающий выбор веб-хука на странице

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

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

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

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

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

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

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

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

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

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

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

Теперь активируйте событие, чтобы узнать, как сетка событий распределяет сообщение в конечную точку.

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

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

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

  2. Выберите + Container. Введите имя контейнера, выберите любой уровень доступа и нажмите кнопку "Создать".

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

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

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

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

    Снимок экрана страницы загрузки блоба для загрузки примера изображения.

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

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

    Снимок экрана, показывающий страницу просмотрщика Event Grid с событием создания BLOB.

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

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

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

Дополнительные сведения о том, что может помочь служба "Сетка событий", см. в следующих ресурсах: