이 페이지에서는 App Engine 표준 환경용 Endpoints Frameworks와 OpenAPI 또는 gRPC를 사용하는 API용 Cloud Endpoints에서 사용되는 Extensible Service Proxy (ESP)의 차이점을 설명합니다. Endpoints 옵션에 관한 자세한 내용은 Endpoints 옵션 선택을 참고하세요.
개요
Cloud Endpoints는 Google에서 자체 API에 사용하는 것과 동일한 인프라를 사용하여 API를 보호, 모니터링, 분석하고 할당량을 설정하는 데 도움이 되는 API 관리 시스템입니다. API 관리 기능에는 API 구현에 사용되는 기술과 무관한 인증, API 키, 모니터링, 로깅, 추적이 포함됩니다. API 관리 기능은 ESP나 Cloud Endpoints 프레임워크를 통해 제공됩니다.
확장 가능 서비스 프록시
OpenAPI 및 gRPC용 Endpoints에서 API 요청은 키와 인증 토큰을 검증하고 Service Control API를 사용하여 신호 (측정항목 및 로그)를 전송하는 Extensible Service Proxy를 통해 리레이됩니다. ESP에서 제공하는 분리는 어떤 언어로든 REST 또는 gRPC 백엔드 코드를 작성할 수 있고 gRPC 또는 OpenAPI를 사용하여 API 설명을 지원하는 모든 프레임워크를 사용할 수 있다는 것을 의미합니다.
OpenAPI를 사용하는 API: API 백엔드는 App Engine 가변형 환경, Google Kubernetes Engine(GKE), Compute Engine, Kubernetes 또는 온프레미스 배포에서 실행할 수 있습니다.
gRPC를 사용하는 API: API 백엔드는 GKE, Compute Engine, Kubernetes 또는 온프레미스 배포에서 실행할 수 있습니다.
다음 경로를 통해 요청이 전송됩니다.
- 코드에 대한 요청이 수신되고 ESP로 전송됩니다.
- ESP가 Service Control에 확인 요청을 보냅니다.
- API 키나 인증을 요구하도록 API를 구성한 경우 Service Control이 요청 허용 여부를 확인하고 ESP로 다시 응답을 보냅니다.
- 요청이 허용되지 않으면 ESP가 요청을 거부합니다. 요청이 허용되면 백엔드 코드에 전달됩니다. 두 경우 모두 ESP가 요청에 대한 정보를 로깅합니다.
Endpoints API 관리 가격은 월별 호출 수에 따라 다릅니다.
Endpoints 프레임워크
App Engine 표준 환경에서 실행되는 API 백엔드의 경우 개발자가 API를 신속하게 제공할 수 있도록 Endpoints Frameworks를 사용할 수 있습니다. Endpoints Frameworks는 웹 프레임워크이며 Python Flask 또는 Java Jersey 대신 사용할 수 있습니다. Endpoints 프레임워크는 Service Control API와 통합됩니다. 이는 Endpoints 프레임워크를 사용하는 백엔드가 확장 가능 서비스 프록시 뒤에서 실행될 필요가 없음을 의미합니다.
API 관리를 사용 설정한 경우 다음 경로를 통해 요청이 전송됩니다.
- 코드에 대한 요청이 수신되고 Endpoints 프레임워크 내의 Endpoints 관리 모듈로 전송됩니다.
- Endpoints 관리 모듈이 Service Control에 대한 확인 요청을 보냅니다.
- API 키나 인증을 요구하도록 API를 구성한 경우 Service Control이 요청 허용 여부를 확인하고 Endpoints 관리 모듈로 다시 응답을 보냅니다.
- 요청이 허용되지 않으면 Endpoints 관리 모듈이 요청을 거부합니다. 요청이 허용되면 Endpoints Frameworks에 전달됩니다. 두 경우 모두 Endpoints 관리 모듈이 요청에 대한 정보를 로깅합니다.
- Endpoints 프레임워크가 요청을 백엔드 코드로 라우팅합니다.
API 관리 기능을 포함하거나 포함하지 않고 Endpoints 프레임워크를 사용할 수 있습니다. API 관리 기능 없이 Endpoints 프레임워크를 사용하는 것은 무료입니다. API 관리 기능 비용은 Endpoints 가격 책정 페이지에 따라 청구됩니다.
Endpoints 프레임워크는 App Engine 표준 환경에서 실행 중인 서비스에서만 지원됩니다. Compute Engine, GKE, App Engine 가변형 환경 또는 기타 환경에서는 서비스가 ESP 뒤에서 실행되어야 합니다.
서비스가 ESP 뒤에서 실행되는 경우 Python Flask, 자바 Jersey 또는 Node.js Express와 같은 모든 언어와 프레임워크로 백엔드 코드를 작성할 수 있습니다. 이러한 환경에서는 API 관리를 위해 Endpoints 프레임워크를 사용할 필요가 없습니다.
다음 단계
API 관리 추가에 대한 자세한 내용은 다음을 참조하세요.
API 관리 삭제에 대한 자세한 내용은 다음을 참조하세요.