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

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

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

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

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

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

   

2. На странице "Начало работы" введите Кэш Azure для Redis в поле поиска. Затем выберите Создать.

   

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

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

4. Выберите вкладку Сети или нажмите кнопку Сети в нижней части страницы.

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

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

   

   • Для кэшей "Базовый" или "Стандартный" переключите выбор порта, отличного от TLS. Вы также можете выбрать, нужно ли включить проверку подлинности Microsoft Entra.
   • Для кэша Premium настройте параметры для порта, не относяющегося к TLS, кластеризации, управляемому удостоверению и сохраняемости данных. Вы также можете выбрать, нужно ли включить проверку подлинности Microsoft Entra.

   Внимание

   Для оптимальной безопасности корпорация Майкрософт рекомендует использовать идентификатор Microsoft Entra с управляемыми удостоверениями для авторизации запросов к кэшу по возможности. Авторизация с помощью идентификатора Microsoft Entra и управляемых удостоверений обеспечивает более высокую безопасность и удобство использования при авторизации общего ключа. Дополнительные сведения об использовании управляемых удостоверений с кэшами см. в разделе "Использование идентификатора Microsoft Entra для проверки подлинности кэша".

7. Выберите вкладку Next: Tags (Далее: теги) или нажмите в нижней части страницы кнопку Next: Tags (Далее: теги).

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

9. Выберите Review + create (Просмотреть и создать). Вы будете перенаправлены на вкладку Проверка и создание, где Azure проверит вашу конфигурацию.

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

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

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

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

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

   

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

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

   Параметр	Предлагаемое значение	Description
   Подписка	Раскройте список и выберите нужную подписку.	Подписка, в которой вы хотите создать это веб-приложение.
   Группа ресурсов	Раскройте список и выберите группу ресурсов или нажмите Создать и введите имя для новой группы ресурсов.	Поместив все ресурсы приложения в одну группу ресурсов, вы сможете легко управлять ими и/или удалить их вместе.
   Имя сайта	Введите имя для веб-приложения.	Это значение не может быть пустым.
   Имя плана размещения	Введите имя для плана службы приложений, в котором будет размещаться веб-приложение.	Это значение не может быть пустым.

3. На портале перейдите к оповещениям (значок колокольчика) и выберите Перейти к группе ресурсов.

   

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

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

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

   

Регистрация поставщика ресурсов Сетки событий

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

На портале Azure сделайте следующее:

1. В меню слева выберите Подписки.

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

3. На странице Подписка выберите Поставщики ресурсов в разделе Параметры в меню слева.

4. Найдите Microsoft.EventGrid и убедитесь, что состояние не зарегистрировано.

5. Выберите Microsoft.EventGrid в списке поставщиков.

6. Выберите Зарегистрировать на панели команд.

   

7. Обновите страницу, чтобы убедиться, что состояние Microsoft.EventGrid изменено на Зарегистрировано.

   

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

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

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

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

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

   

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

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

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

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

   

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

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

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

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

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

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

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

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

   

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

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

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

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

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

• Реагирование на события Кэша Azure для Redis
• An introduction to Azure Event Grid (Общие сведения о службе "Сетка событий Azure")