Azure API Management에서 외부 Redis 호환 캐시 사용

적용 대상: 모든 API Management 계층

Azure API Management는 기본 제공 캐시를 활용하는 것 외에도 외부 Redis 호환 캐시(예: Azure Cache for Redis)에서 응답을 캐시할 수 있습니다.

외부 캐시를 사용하면 기본 제공 캐시의 몇 가지 제한 사항을 극복할 수 있습니다.

• API Management 업데이트 중에 캐시를 주기적으로 지우지 않도록 방지
• 캐시 구성에 대한 더 자세한 제어
• API Management 계층에서 허용하는 것보다 더 많은 데이터 캐시
• API Management의 소비 계층에서 캐싱 사용
• API Management 자체 호스팅 게이트웨이에서 캐싱 사용

캐싱에 대한 자세한 내용은 API Management 캐싱 정책과 Azure API Management의 사용자 지정 캐싱을 참조하세요.

학습할 내용:

필수 조건

이 자습서를 완료하려면 다음이 필요합니다.

• Azure API Management 인스턴스 만들기
• Azure API Management에서 캐싱에 대한 이해

Azure Cache for Redis 만들기

이 섹션에서는 Azure에서 Azure Cache for Redis를 만드는 방법을 설명합니다. Azure 내부 또는 외부에 Azure Cache for Redis 또는 Redis 규격 캐시가 이미 있으면 다음 섹션으로 건너뛸 수 있습니다.

1. 캐시를 만들려면 Azure Portal에 로그인합니다. 포털 메뉴에서 리소스 만들기를 선택합니다.

   

2. 시작 창의 검색 창에서 Aure Cache for Redis를 입력합니다. 검색 결과에서 Azure Cache for Redis를 찾은 다음, 만들기를 선택합니다.

   

3. 새 Redis Cache 창의 기본 탭에서 캐시에 대해 다음 설정을 구성합니다.

   설정	작업	설명
   구독	Azure 구독을 선택합니다.	Azure Cache for Redis의 새 인스턴스를 만드는 데 사용할 구독.
   리소스 그룹	리소스 그룹을 선택하거나 새로 만들기를 선택하고 새 리소스 그룹 이름을 입력합니다.	캐시 및 기타 리소스를 만들 리소스 그룹의 이름. 모든 앱 리소스를 하나의 리소스 그룹에 배치하면 앱 리소스를 쉽게 관리하거나 삭제할 수 있습니다.
   DNS 이름	고유한 이름을 입력합니다.	캐시 이름은 숫자, 문자 및 하이픈만 포함하는 1~63자의 문자열이어야 합니다. 이름은 숫자 또는 문자로 시작하고 끝나야 하며 연속 하이픈을 포함할 수 없습니다. 캐시 인스턴스의 호스트 이름은 \<DNS name>.redis.cache.windows.net입니다.
   위치	위치를 선택합니다.	캐시를 사용하는 다른 서비스 근처에 있는 Azure 지역.
   캐시 SKU	SKU를 선택합니다.	SKU는 캐시에 사용할 수 있는 크기, 성능 및 기능 매개 변수를 결정합니다. 자세한 내용은 Azure Cache for Redis 개요를 참조하세요.
   캐시 크기	캐시 크기를 선택합니다.	자세한 내용은 Azure Cache for Redis 개요를 참조하세요.

4. 네트워킹 탭을 선택하거나 다음: 네트워킹을 선택합니다.

5. 네트워킹 탭에서 캐시에 사용할 연결 방법을 선택합니다.

6. 고급 탭을 선택하거나 다음: 고급을 선택합니다.

7. 고급 창에서 다음 정보에 따라 인증 방법을 확인하거나 선택합니다.

   

   • 기본적으로 새 기본, 표준 또는 프리미엄 캐시의 경우 Microsoft Entra 인증이 활성화되고 액세스 키 인증이 비활성화됩니다.
   • 기본 또는 표준 캐시의 경우 비 TLS 포트 선택 영역을 선택/해제할 수 있습니다.
   • 표준 및 프리미엄 캐시의 경우 가용성 영역을 사용하도록 선택할 수 있습니다. 캐시를 만든 후에는 가용성 영역을 비활성화할 수 없습니다.
   • 프리미엄 캐시의 경우 비 TLS 포트, 클러스터링, 관리 ID 및 데이터 지속성에 대한 설정을 구성합니다.

   Important

   최적의 보안을 위해 관리 ID와 함께 Microsoft Entra ID를 사용하여 가능한 경우 캐시에 대한 요청에 권한을 부여하는 것이 좋습니다. Microsoft Entra ID 및 관리 ID를 사용한 인증은 공유 액세스 키 인증에 비해 뛰어난 보안과 사용 편의성을 제공합니다. 캐시에서 관리 ID를 사용하는 방법에 대한 자세한 내용은 캐시 인증을 위한 Microsoft Entra ID 사용을 참조하세요.

8. (선택 사항) 태그 탭을 선택하거나 다음: 태그를 선택합니다.

9. (선택 사항) 태그 탭에서 캐시 리소스를 분류하려는 경우 태그 이름과 값을 입력합니다.

10. 검토 + 만들기 단추를 선택합니다.

    검토 + 만들기 탭에서 Azure는 자동으로 구성의 유효성을 검사합니다.

11. 녹색 유효성 검사 통과 메시지가 표시되면 만들기를 선택합니다.

새 캐시 배포는 몇 분 동안 발생합니다. Azure Cache for Redis 개요 창에서 배포 진행률을 모니터링할 수 있습니다. 상태가 실행 중으로 표시되면 캐시를 사용할 준비가 된 것입니다.

Kubernetes에 Redis 캐시 배포

자체 호스팅 게이트웨이의 경우 캐싱에 외부 캐시가 필요합니다. 캐싱이 효과적이려면 자체 호스팅 게이트웨이와 해당 게이트웨이가 사용하는 캐시는 조회 및 저장 대기 시간을 최소화하기 위해 서로 가까이 있어야 합니다. Redis 캐시를 동일한 Kubernetes 클러스터 또는 인접한 별도 클러스터에 배포하는 것이 가장 좋은 옵션입니다. Redis 캐시를 Kubernetes 클러스터에 배포하는 방법을 알아봅니다.

외부 캐시 추가

아래 단계에 따라 Azure API Management에서 외부 Redis 규격 캐시를 추가합니다. 캐시를 API Management 인스턴스의 특정 게이트웨이로 제한할 수 있습니다.

다음에서 사용 설정

구성의 다음에서 사용 설정은 캐시를 사용할 API Management 인스턴스의 위치를 지정합니다. 다음 중 하나를 선택합니다.

• API Management 인스턴스가 호스트되는 Azure 지역(또는 다중 지역 배포가 있는 경우 구성된 위치 중 하나)

• 자체 호스팅 게이트웨이 위치

• 기본값 - API Management 인스턴스에서 모든 게이트웨이 위치의 기본값으로 캐시 구성

  기본값에 사용되는 캐시는 특정 일치 지역 또는 위치에 사용되는 캐시에 의해 재정의됩니다.

  예를 들어, 미국 동부, 동남 아시아 및 서유럽 지역에서 호스트되는 API Management 인스턴스를 고려합니다. 두 개의 캐시가 구성되어 있습니다. 하나는 기본값이고 다른 하나는 동남 아시아에 해당합니다. 이 예제에서 동남 아시아의 API Management는 자체 캐시를 사용하지만 다른 두 지역은 기본 캐시 항목을 사용합니다.

같은 구독에서 Azure Cache for Redis 추가

1. Azure Portal에서 API Management 인스턴스로 이동합니다.
2. 왼쪽 메뉴에서 외부 캐시 탭을 선택합니다.
3. + 추가 단추를 선택합니다.
4. 캐시 인스턴스 드롭다운 필드에서 캐시를 선택합니다.
5. 기본값을 선택하거나 다음에서 사용 드롭다운 필드에 원하는 지역을 지정합니다.
6. 저장을 선택합니다.

현재 Azure 구독 또는 일반적으로 Azure 외부에서 호스트되는 Redis 규격 캐시 추가

1. Azure Portal에서 API Management 인스턴스로 이동합니다.
2. 왼쪽 메뉴에서 외부 캐시 탭을 선택합니다.
3. + 추가 단추를 선택합니다.
4. 캐시 인스턴스 드롭다운 필드에서 사용자 지정을 선택합니다.
5. 기본값을 선택하거나 다음에서 사용 드롭다운 필드에 원하는 지역을 지정합니다.
6. 연결 문자열 필드에서 Azure Cache for Redis(또는 Redis 규격 캐시) 연결 문자열을 제공합니다.
7. 저장을 선택합니다.

자체 호스팅 게이트웨이에 Redis 캐시 추가

1. Azure Portal에서 API Management 인스턴스로 이동합니다.
2. 왼쪽 메뉴에서 외부 캐시 탭을 선택합니다.
3. + 추가 단추를 선택합니다.
4. 캐시 인스턴스 드롭다운 필드에서 사용자 지정을 선택합니다.
5. 다음에서 사용 드롭다운 필드에서 원하는 자체 호스팅 게이트웨이 위치 또는 기본값을 지정합니다.
6. 연결 문자열 필드에서 Redis 캐시 연결 문자열을 제공합니다.
7. 저장을 선택합니다.

외부 캐시 사용

Redis 규격 캐시를 추가한 후 외부 캐시에서 응답 캐싱 또는 키별 값 캐싱을 사용하도록 캐싱 정책을 구성합니다.

자세한 예제는 Azure API Management에서 캐싱을 추가하여 성능 향상을 참조하세요.

다음 단계

• 캐싱 정책에 대한 자세한 내용은 API Management 정책 참조의 캐싱 정책을 참조하세요.
• 정책 식을 사용하여 키별 항목을 캐시하려면 Azure API Management에서 사용자 지정 캐싱을 참조하세요.