OpenAPI용 Cloud Endpoints

Cloud Endpoints는 Google이 자체 API에 사용하는 인프라와 동일한 인프라를 사용하여 API의 보안, 모니터링, 분석, 할당량 설정을 지원하는 API 관리 시스템입니다. Endpoints는 Extensible Service Proxy(ESP)와 함께 작동하여 API 관리 기능을 제공합니다. Endpoints 및 ESP에 대한 자세한 내용은 Cloud Endpoints 정보를 참조하세요.

Endpoints는 REST API를 정의하는 업계 표준인 OpenAPI 사양(이전 Swagger 사양) 버전 2를 지원합니다. OpenAPI 사양에 대해 잘 모르는 경우 OpenAPI 개요를 참조하세요.

이 문서에서는 OpenAPI에 Endpoints를 사용하는 방법을 보여줍니다. 다른 Endpoints 옵션에 대한 문서는 모든 Endpoints 문서를 참조하세요.

시작하려면 다음과 같은 순서에 따라 문서를 확인하는 것이 좋습니다.

  1. Endpoints 기능 작동을 확인하려면 Cloud Endpoints 빠른 시작을 참조하세요. 이 문서에서는 스크립트를 사용하여 App Engine 가변형 환경에 샘플 API를 배포합니다.

  2. 이제 API에 사용할 컴퓨팅 플랫폼을 결정해야 합니다. 컴퓨팅 옵션 선택과 아래의 지원되는 컴퓨팅 플랫폼 섹션은 플랫폼을 결정하는 데 도움이 됩니다.

  3. API의 백엔드를 결정했으면 선호하는 컴퓨팅 플랫폼의 가이드를 살펴봅니다.

지원되는 컴퓨팅 플랫폼

OpenAPI용 Endpoints는 API 관리를 위해 ESP를 사용합니다. ESP는 오픈소스 프로젝트이며 다음과 같은 방법으로 제공됩니다.

  • Google Container Registry의 컨테이너. 현재 Docker 이미지는 ESP 출시 노트를 참조하세요.
  • GitHub의 소스 코드. ESP 구축에 대한 자세한 내용은 ESP README를 참조하세요.

다음에서 직접 ESP 컨테이너를 실행할 수 있습니다.

App Engine 가변형 환경에서는 app.yaml 파일에 몇 줄만 추가하면 ESP가 자동으로 배포됩니다. 자세한 내용은 API 및 ESP 배포를 참조하세요.

App Engine 표준 1세대 환경의 경우 Endpoints 프레임워크를 사용해야 합니다. 대신 위의 컴퓨팅 옵션 중 하나에 컨테이너를 배포하는 경우에는 App Engine 표준 런타임 세대 중 하나에 프록시할 수 있습니다.