Использование внешнего кэша, совместимого с Redis, в службе управления API Azure

Статья
02/21/2024

ОБЛАСТЬ ПРИМЕНЕНИЯ: все уровни Управление API

Помимо использования встроенного кэша служба управления API Azure также позволяет кэшировать ответы во внешнем кэше, совместимом с Redis, например в кэше Azure для Redis.

Использование внешнего кэша позволяет обойти ряд ограничений встроенного кэша:

избежать периодического очищения кэша при обновлении службы управления API;
получить больший контроль над конфигурацией кэша;
кэшировать больше данных, чем позволяет уровень службы управления API;
использовать кэширование на уровне "Потребление" службы управления API.
включать кэширование в самостоятельно размещенных шлюзах управления API

Дополнительные сведения о кэшировании см. в статьях Политики кэширования в службе "Управление API" и Пользовательское кэширование в службе "Управление API Azure".

Добавление своего собственного кэша в APIM

Из этого руководства вы узнаете, как выполнять такие задачи:

Добавление внешнего кэша в службу управления API

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

Для работы с этим руководством вам потребуется следующее:

Создание экземпляра службы управления API Azure
Понимание принципа кеширования в службе управления API Azure

Создание кэша Redis для Azure

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

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

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

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

Выберите вкладку Сети или нажмите кнопку Сети в нижней части страницы.
На вкладке Сети выберите способ подключения.
Нажмите кнопку "Далее" или нажмите кнопку "Далее" в нижней части страницы, чтобы просмотреть вкладку "Дополнительно".
- Для кэшей "Базовый" или "Стандартный" переключите выбор порта, отличного от TLS. Вы также можете выбрать, нужно ли включить проверку подлинности Microsoft Entra.
- Для кэша Premium настройте параметры для порта, отличного от TLS, кластеризация, управляемого удостоверения и сохраняемости данных. Вы также можете выбрать, нужно ли включить проверку подлинности Microsoft Entra.
Выберите вкладку Next: Tags (Далее: теги) или нажмите в нижней части страницы кнопку Next: Tags (Далее: теги).
При необходимости на вкладке Теги введите имя и значение, чтобы классифицировать ресурс.
Выберите Review + create (Просмотреть и создать). Вы будете перенаправлены на вкладку Проверка и создание, где Azure проверит вашу конфигурацию.
Когда отобразится сообщение "Проверка пройдена" зеленого цвета, выберите Создать.

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

Развертывание кэша Redis в Kubernetes

Для самостоятельно размещенного шлюза кэширование требует внешнего кэша. Чтобы кэширование было эффективным, самостоятельно размещенный шлюз и используемый им кэш должны располагаться рядом друг с другом, чтобы задержки при поиске и сохранении данных были минимальными. Лучше всего развертывать кэш Redis в том же кластере Kubernetes или в отдельном кластере поблизости. Узнайте, как развернуть кэш Redis в кластере Kubernetes.

Добавление внешнего кэша

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

На снимке экрана показано, как добавить внешний Кэш Azure для Redis в службу управления API Azure.

Параметр "Использовать из"

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

Регион Azure, в котором размещен экземпляр службы управления API (или одно из настроенных расположений в случае развертывания в нескольких регионах)
Расположение самостоятельно размещенного шлюза
По умолчанию, чтобы настроить кэш как значение по умолчанию для всех расположений шлюза в экземпляре службы управления API

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

Например, рассмотрим экземпляр службы управления API, размещенный в регионах "Восток США", "Юго-Восточная Азия" и "Западная Европа". Настроено два кэша, один— для значения По умолчанию, а другой — для Юго-Восточной Азии. В этом примере служба управления API в Юго-Восточной Азии будет использовать собственный кэш, а в двух других регионах будет использоваться запись кэша по умолчанию.

Примечание.

Можно настроить один и тот же внешний кэш для нескольких экземпляров службы управления API. Экземпляры службы управления API могут находиться в одном или разных регионах. При совместном использовании кэша для нескольких экземпляров необходимо выбрать значение По умолчанию для параметра Использовать из.

Добавление кэша Redis для Azure из той же подписки

Перейдите к экземпляру службы управления API на портале Azure.
Выберите вкладку External cache (Внешний кэш) в меню слева.
Нажмите кнопку + Добавить.
В раскрывающемся поле Cache instance (Экземпляр кэша) выберите свой кэш.
Выберите вариант По умолчанию или укажите нужный регион в поле с раскрывающимся списком Использовать из.
Выберите Сохранить.

Добавление совместимого с Redis кэша, размещенного вне текущей подписки Azure или полностью за пределами Azure

Перейдите к экземпляру службы управления API на портале Azure.
Выберите вкладку External cache (Внешний кэш) в меню слева.
Нажмите кнопку + Добавить.
В раскрывающемся поле Cache instance (Экземпляр кэша) выберите Custom (Настраиваемый).
Выберите вариант По умолчанию или укажите нужный регион в поле с раскрывающимся списком Использовать из.
В поле Строка подключения укажите строку подключения к кэшу Azure для Redis (или совместимому с Redis кэшу).
Выберите Сохранить.

Добавление кэша Redis к локальному шлюзу

Перейдите к экземпляру службы управления API на портале Azure.
Выберите вкладку External cache (Внешний кэш) в меню слева.
Нажмите кнопку + Добавить.
В раскрывающемся поле Cache instance (Экземпляр кэша) выберите Custom (Настраиваемый).
Укажите желаемое расположение самостоятельно размещенного шлюза или значение По умолчанию в поле с раскрывающимся списком Использовать из.
В поле Connection string (Строка подключения) укажите строку подключения к кэшу Redis.
Выберите Сохранить.