2.6. 경로 라우팅

APIcast는 3scale 계정에 구성된 모든 API 서비스(또는 APICAST_SERVICES_LIST 환경 변수가 구성된 경우 서비스의 서브 세트)를 처리합니다. 일반적으로 APIcast는 Public Base URL 과 일치시켜 요청의 호스트 이름을 기반으로 API 요청을 적절한 API 서비스로 라우팅합니다. 일치가 확인된 첫 번째 서비스는 권한 부여에 사용됩니다.

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

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

예를 들어 다음과 같은 방식으로 3개의 서비스가 구성됩니다.

경로 라우팅이 비활성화 된 경우(APICAST_PATH_ROUTING=false)에 대한 모든 호출은 서비스 A.example.com과 일치하려고 합니다. 따라서 api.example.com 및 api.example.com/b 호출은 "No Mapping Rule matched" 오류와 함께 실패합니다.

경로 라우팅이 활성화되면 (APICAST_PATH_ROUTING=true) 호출이 호스트 및 경로와 일치합니다. 예를 들면 다음과 같습니다.

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