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

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

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

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

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

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

Примечание.

В настоящее время эта функция недоступна в рабочих областях.

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

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

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

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

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

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

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

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

   

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

   

3. На панели "Новый кэш Redis" на вкладке "Основы" настройте следующие параметры для кэша:

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

4. Перейдите на вкладку "Сеть" или нажмите кнопку "Далее: сеть".

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

6. Выберите вкладку "Дополнительно" или нажмите кнопку "Далее".

7. На панели "Дополнительно" проверьте или выберите метод проверки подлинности на основе следующих сведений:

   

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

   Внимание

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

8. (Необязательно) Выберите вкладку "Теги" или нажмите кнопку "Далее: теги".

9. (Необязательно) На вкладке "Теги" введите имя и значение тега, если вы хотите классифицировать ресурс кэша.

10. Нажмите кнопку Просмотреть и создать.

    На вкладке "Проверка и создание " Azure автоматически проверяет конфигурацию.

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

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

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

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

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

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

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

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

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

• Расположение самостоятельно размещенного шлюза

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

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

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

Примечание.

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

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

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

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

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

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

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

Использование внешнего кэша

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

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

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

• Дополнительные сведения о политиках кэширования см. в разделе Политики кэшированиясправочника по политикам управления API.
• Сведения о кэшировании элементов по ключу с помощью выражений политики см. в статье Пользовательское кэширование в службе управления API Azure.