4.6. 경로 라우팅


APIcast는 3scale 계정에 구성된 모든 API 서비스를 처리합니다(또는 APICAST_SERVICES_LIST 환경 변수가 구성된 경우 서비스의 하위 집합). 일반적으로 APIcast는 공용 기본 URL 과 일치하여 요청의 호스트 이름을 기반으로 API 요청을 적절한 API 서비스로 라우팅합니다. 일치 항목이 있는 첫 번째 서비스는 권한 부여에 사용됩니다.

경로 라우팅 기능을 사용하면 여러 서비스에서 동일한 공용 기본 URL 을 사용할 수 있으며 요청 경로를 사용하여 요청을 라우팅할 수 있습니다. 기능을 활성화하려면 APICAST_PATH_ROUTING 환경 변수를 true 또는 1 로 설정합니다. 이 기능을 활성화하면 APIcast는 호스트 이름과 경로를 기반으로 들어오는 요청을 서비스에 매핑합니다.

이 기능은 동일한 공용 기본 URL 을 사용하는 하나의 게이트웨이를 통해 다른 도메인에 호스팅되는 여러 백엔드 서비스를 노출하려는 경우에 사용할 수 있습니다. 이를 위해 각 API 백엔드(예: Private Base URL)에 대해 여러 API 서비스를 구성하고 경로 라우팅 기능을 활성화할 수 있습니다.

예를 들어 다음과 같은 방법으로 3개의 서비스가 구성되어 있습니다.

  • Service A Public Base URL: api.example.com Mapping 규칙: /a
  • Service B Public Base URL: api2.example.com Mapping 규칙: /b
  • Service C Public Base URL: api.example.com Mapping 규칙: /c

경로 라우팅이 비활성화되어 있는 경우(APICAST_PATH_ROUTING=false), api.example.com 에 대한 모든 호출은 서비스 A. 즉, api.example.com/capi.example.com/b 호출이 "No Mapping Rule matched" 오류와 함께 실패합니다.

경로 라우팅이 활성화된 경우(APICAST_PATH_ROUTING=true) 호스트 및 경로와 모두 호출이 일치합니다. so:

  • api.example.com/a 는 서비스 A로 라우팅됩니다.
  • api.example.com/c 는 Service C로 라우팅됩니다.
  • api.example.com/b 는 "No Mapping Rule matched" 오류로 인해 실패합니다. 즉, Public Base URL 이 일치하지 않기 때문에 서비스 B와 일치하지 않습니다.

경로 라우팅을 사용하는 경우 동일한 공개 기본 URL 을 사용하는 여러 서비스의 매핑 규칙 간에 충돌이 없는지 확인해야 합니다. 즉 메서드 + 경로 패턴의 각 조합은 하나의 서비스에서만 사용됩니다.

맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat