Azure API Management에서 외부 Redis 호환 캐시 사용
적용 대상: 모든 API Management 계층
Azure API Management는 기본 제공 캐시를 활용하는 것 외에도 Azure Cache for Redis 또는 Azure Managed Redis와 같은 외부 Redis 호환 캐시에서 응답을 캐싱할 수 있습니다.
외부 캐시를 사용하면 기본 제공 캐시의 몇 가지 제한 사항을 극복할 수 있습니다.
- API Management 업데이트 중에 캐시를 주기적으로 지우지 않도록 방지
- 캐시 구성에 대한 더 자세한 제어
- API Management 계층에서 허용하는 것보다 더 많은 데이터 캐시
- API Management의 소비 계층에서 캐싱 사용
- API Management 자체 호스팅 게이트웨이에서 캐싱 사용
캐싱에 대한 자세한 내용은 API Management 캐싱 정책과 Azure API Management의 사용자 지정 캐싱을 참조하세요.
참고 항목
현재 이 기능은 작업 영역에서 사용할 수 없습니다.
학습할 내용:
- API Management에서 외부 캐시 추가
필수 조건
이 자습서를 완료하려면 다음이 필요합니다.
Azure API Management에서 캐싱에 대한 이해
Azure Cache for Redis, Azure Managed Redis 또는 다른 Redis 호환 캐시를 사용할 수 있습니다.
Important
Azure API Management는 Redis 연결 문자열 사용하여 캐시에 연결합니다. Azure Cache for Redis 또는 Azure Managed Redis를 사용하는 경우 캐시에서 액세스 키 인증을 사용하도록 설정하여 연결 문자열 사용합니다. 현재는 Microsoft Entra 인증을 사용하여 Azure API Management를 Azure Cache for Redis 또는 Azure Managed Redis에 연결할 수 없습니다.
Kubernetes용 Redis 캐시
API Management 자체 호스팅 게이트웨이의 경우 캐싱에 외부 캐시가 필요합니다. 캐싱이 효과적이려면 자체 호스팅 게이트웨이와 해당 게이트웨이가 사용하는 캐시는 조회 및 저장 대기 시간을 최소화하기 위해 서로 가까이 있어야 합니다. Redis 캐시를 동일한 Kubernetes 클러스터 또는 인접한 별도 클러스터에 배포하는 것이 가장 좋은 옵션입니다. Redis 캐시를 Kubernetes 클러스터에 배포하는 방법을 알아봅니다.
외부 캐시 추가
아래 단계에 따라 Azure API Management에서 외부 Redis 규격 캐시를 추가합니다. 캐시를 API Management 인스턴스의 특정 게이트웨이로 제한할 수 있습니다.
다음에서 사용 설정
구성의 다음에서 사용 설정은 캐시를 사용할 API Management 인스턴스의 위치를 지정합니다. 다음 중 하나를 선택합니다.
API Management 인스턴스가 호스트되는 Azure 지역(또는 다중 지역 배포가 있는 경우 구성된 위치 중 하나)
자체 호스팅 게이트웨이 위치
기본값 - API Management 인스턴스에서 모든 게이트웨이 위치의 기본값으로 캐시 구성
기본값에 사용되는 캐시는 일치하는 특정 지역 또는 위치에 사용되는 캐시에 의해 재정의됩니다.
예를 들어, 미국 동부, 동남 아시아 및 서유럽 지역에서 호스트되는 API Management 인스턴스를 고려합니다. 두 개의 캐시가 구성되어 있습니다. 하나는 기본값이고 다른 하나는 동남 아시아에 해당합니다. 이 예제에서 동남 아시아의 API Management는 자체 캐시를 사용하는 반면 다른 두 지역은 기본 캐시 항목을 사용합니다.
참고 항목
둘 이상의 API Management 인스턴스에 대해 동일한 외부 캐시를 구성할 수 있습니다. API Management 인스턴스는 동일하거나 서로 다른 지역에 있을 수 있습니다. 둘 이상의 인스턴스에 대한 캐시를 공유하는 경우 다음에서 사용 설정에서 기본값을 선택해야 합니다.
동일한 구독에서 Azure Cache for Redis 또는 Azure Managed Redis 인스턴스 추가
- Azure Portal에서 API Management 인스턴스로 이동합니다.
- 왼쪽 메뉴의 배포 + 인프라에서 외부 캐시를 선택합니다.
- + 추가를 선택합니다.
- 캐시 인스턴스 드롭다운에서 캐시를 선택합니다.
- 드롭다운에서 사용 드롭다운에서 기본값을 선택하거나 원하는 지역을 지정합니다. 연결 문자열이 자동으로 채워집니다.
- 저장을 선택합니다.
현재 Azure 구독 또는 일반적으로 Azure 외부에서 호스트되는 Redis 규격 캐시 추가
- Azure Portal에서 API Management 인스턴스로 이동합니다.
- 왼쪽 메뉴의 배포 + 인프라에서 외부 캐시를 선택합니다.
- + 추가를 선택합니다.
- 캐시 인스턴스 드롭다운에서 사용자 지정을 선택합니다.
- 드롭다운에서 사용 드롭다운에서 기본값을 선택하거나 원하는 지역을 지정합니다.
- 연결 문자열 필드에 Azure Cache for Redis, Azure Managed Redis 또는 Redis 호환 캐시 연결 문자열 입력합니다.
- 저장을 선택합니다.
자체 호스팅 게이트웨이에 Redis 캐시 추가
- 왼쪽 메뉴의 배포 + 인프라에서 외부 캐시를 선택합니다.
- + 추가를 선택합니다.
- 캐시 인스턴스 드롭다운에서 사용자 지정을 선택합니다.
- 드롭다운에서 사용 드롭다운에서 기본값을 선택하거나 원하는 지역을 지정합니다.
- 연결 문자열 필드에 Redis 캐시 연결 문자열 입력합니다.
- 저장을 선택합니다.
외부 캐시 사용
Redis 규격 캐시를 추가한 후 외부 캐시에서 응답 캐싱 또는 키별 값 캐싱을 사용하도록 캐싱 정책을 구성합니다.
자세한 예제는 Azure API Management에서 캐싱을 추가하여 성능 향상을 참조하세요.
관련 콘텐츠
- 캐싱 정책에 대한 자세한 내용은 API Management 정책 참조의 캐싱 정책을 참조하세요.
- 정책 식을 사용하여 키별 항목을 캐시하려면 Azure API Management에서 사용자 지정 캐싱을 참조하세요.
- Azure OpenAI API에 대한 의미 체계 캐싱을 사용하도록 설정하는 방법을 알아봅니다.