Краткое руководство. Маршрутизация событий Кэша Azure для Redis в конечную веб-точку с помощью портала Azure

"Сетка событий Azure" — это служба обработки событий для облака. При работе с этим кратким руководством вы с помощью портала Azure создадите экземпляр Кэша Azure для Redis и подписку на события этого экземпляра, затем сгенерируете событие и проверите полученные результаты. Как правило, события отправляются на конечную точку, которая обрабатывает данные событий и выполняет соответствующие действия. Для простоты в этом кратком руководстве описана отправка событий непосредственно в веб-приложение, которое будет собирать и отображать эти сообщения.

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

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

Масштабирование средства просмотра Сетки событий Azure в формате JSON.

Создание экземпляра Кэша Azure для Redis

  1. Чтобы создать кэш, войдите на портал Azure и выберите Создать ресурс.

    Область навигации слева с выделенным элементом "Создать ресурс"

  2. На странице Создание выберите Базы данных, а затем Кэш Azure для Redis.

    Страница "Создание" с выделенным элементом "Базы данных" и "Кэш Azure для Redis"

  3. На странице Новый кэш Redis настройте параметры для нового кэша.

    Параметр Рекомендуемое значение Description
    DNS-имя Введите глобально уникальное имя Имя кэша должно быть строкой длиной от 1 до 63 символов и содержать только цифры, буквы и дефисы. Имя должно начинаться и заканчиваться цифрой или буквой и не может содержать более одного дефиса подряд. Имя узла для экземпляра кэша получит значение <DNS name>.redis.cache.windows.net.
    подписка Раскройте список и выберите нужную подписку. В этой подписке будет создан новый экземпляр кэша Redis для Azure.
    Группа ресурсов Раскройте список и выберите группу ресурсов или нажмите Создать и введите имя для новой группы ресурсов. Имя группы ресурсов, в которой будут созданы кэш и другие ресурсы. Поместив все ресурсы приложения в одну группу ресурсов, вы сможете легко управлять ими и/или удалить их вместе.
    Местоположение Откройте список и выберите расположение. Выберите оптимальный регион для других служб, которые будут использовать кэш.
    Ценовая категория Откройте список и выберите ценовую категорию. Ценовая категория определяет размер, производительность и функции, доступные для кэша. Дополнительные сведения см. в обзоре предложения "Кэш Redis для Azure".
  4. Выберите вкладку Сети или нажмите кнопку Сети в нижней части страницы.

  5. На вкладке Сети выберите способ подключения.

  6. Нажмите кнопку Далее: дополнительно в нижней части страницы или выберите вкладку Далее: дополнительно.

  7. На вкладке Дополнительно для экземпляра кэша уровня "Базовый" или "Стандартный" установите переключатель, чтобы включить порт, отличный от TLS. Вы также можете выбрать версию Redis, которую вы хотите использовать, например 4 или 6 (ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ).

    Redis версии 4 или 6.

  8. На вкладке Дополнительно для экземпляра кэша уровня "Премиум" настройте параметры для портов, отличных от TLS, а также кластеризацию и сохраняемость данных. Вы также можете выбрать версию Redis, которую вы хотите использовать, например 4 или 6 (ПРЕДВАРИТЕЛЬНАЯ ВЕРСИЯ).

  9. Нажмите кнопку Далее: теги или нажмите кнопку Далее: теги в нижней части страницы.

  10. При необходимости на вкладке Теги введите имя и значение, чтобы классифицировать ресурс.

  11. Выберите Проверить и создать. Вы будете перенаправлены на вкладку "Просмотр и создание", где Azure проверит вашу конфигурацию.

  12. Когда отобразится сообщение "Проверка пройдена" зеленого цвета, выберите Создать.

На создание кэша требуется некоторое время. Вы можете отслеживать ход выполнения на странице обзорных сведений кэша Azure для Redis. Когда Состояние примет значение Running (Выполняется), кэш будет готов к использованию.

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

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

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

Кнопка &quot;Развертывание в Azure&quot;

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

    1. В качестве группы ресурсов выберите ту же группу ресурсов, которую вы создали при создании экземпляра кэша. После завершения работы с руководством вам будет проще выполнить очистку, удалив группу ресурсов.
    2. В поле Имя сайта введите имя веб-приложения.
    3. В поле Имя плана размещения введите имя плана службы приложений для размещения веб-приложения.
    4. Установите флажок Я принимаю указанные выше условия.
    5. Щелкните Приобрести.
    Параметр Рекомендуемое значение Описание
    Подписка Раскройте список и выберите нужную подписку. Подписка, в которой нужно создать веб-приложение.
    Группа ресурсов Раскройте список и выберите группу ресурсов или нажмите Создать и введите имя для новой группы ресурсов. Поместив все ресурсы приложения в одну группу ресурсов, вы сможете легко управлять ими и/или удалить их вместе.
    Имя сайта Введите имя для веб-приложения. Это значение не может быть пустым.
    Имя плана размещения Введите имя для плана службы приложений, в котором будет размещаться веб-приложение. Это значение не может быть пустым.
  2. На портале перейдите к оповещениям (значок колокольчика) и выберите Перейти к группе ресурсов.

    Уведомление о развертывании на портале Azure.

  3. На странице Группа ресурсов в списке ресурсов выберите созданное вами веб-приложение. В этом списке также отображается план службы приложений и экземпляр кэша.

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

  5. Убедитесь, что сайт открывается, но не имеет опубликованных событий.

    Пустой сайт средства просмотра Сетки событий.

Включение поставщика ресурсов службы "Сетка событий"

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

На портале Azure выполните следующие действия.

  1. В меню слева выберите Подписки.
  2. Выберите подписку, которую используете для службы "Сетка событий".
  3. В разделе Параметры выберите Поставщики ресурсов.
  4. Найдите Microsoft.EventGrid.
  5. Если поставщик ресурсов не зарегистрирован, выберите Зарегистрировать.

Регистрация может занять некоторое время. Щелкните Обновить, чтобы обновить состояние. Когда для состояния отобразится значение Зарегистрировано, можно будет продолжить.

Подписка на экземпляр Кэша Azure для Redis

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

  1. На портале перейдите к созданному ранее экземпляру кэша.

  2. На странице Кэш Azure для Redis в меню слева выберите элемент События.

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

    Страница событий на портале Azure.

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

    Параметр Рекомендуемое значение Описание
    имя; Укажите имя подписки на событие. Длина значения должна быть от 3 до 64 символов. Имя может содержать только буквы, цифры и дефисы.
    Типы событий Раскройте список и выберите один или несколько типов событий, которые вы намерены отправлять в это назначение. В нашем примере для этого краткого руководства масштабируется экземпляр кэша. Доступны следующие действия: установка исправлений, масштабирование, импорт и экспорт.
    Тип конечной точки Щелкните элемент Веб-перехватчик. Это обработчик событий, который будет получать события.
    Конечная точка Щелкните Выбрать конечную точку, введите URL-адрес веб-приложения и добавьте строку api/updates к URL-адресу домашней страницы (например, https://cache.azurewebsites.net/api/updates). Затем нажмите кнопку Подтвердить выбор. Это URL-адрес ранее созданного вами веб-приложения.
  5. Теперь на странице Создать подписку на события нажмите кнопку Создать, чтобы создать подписку на события.

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

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

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

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

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

  2. Выберите нужную ценовую категорию на странице Масштабирование и щелкните элемент Выбрать.

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

    • Перейти с более высокой ценовой категории на более низкую нельзя.
      • Ценовую категорию кэша Премиум нельзя изменить на категорию Стандартный или Базовый.
      • Ценовую категорию кэша Стандартный нельзя изменить на категорию Базовый.
    • Вы можете выполнить масштабирование кэша с уровня Базовый до уровня Стандартный, но вам не удастся одновременно с этим изменить размер кэша. Если требуется изменить размер, можно выполнить последующую операцию масштабирования до нужного размера.
    • Ценовую категорию кэша Базовый нельзя изменить сразу на уровень Премиум. Сначала перейдите с категории Базовый на категорию Стандартный, а затем — с категории Стандартный на категорию Премиум.
    • Вам не удастся выполнить масштабирование с большего размера до размера C0 (250 МБ) .

    Во время масштабирования кэша до новой ценовой категории в колонке Кэш Azure для Redis отображается состояние Масштабирование. После завершения масштабирования состояние меняется с Масштабирование на Работает.

  3. Вы активировали событие, а служба "Сетка событий" отправила сообщение в конечную точку, настроенную вами при оформлении подписки. Сообщение имеет формат JSON и содержит массив с одним или несколькими событиями. В следующем примере сообщение JSON содержит массив с одним событием. Просмотрите веб-приложение. Вы увидите полученное событие ScalingCompleted (Масштабирование завершено).

    Масштабирование средства просмотра Сетки событий Azure в формате JSON.

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

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

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

Дальнейшие действия

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