Cloud Endpoints는 Google이 자체 API에 사용하는 인프라와 동일한 인프라를 사용하여 API의 보안, 모니터링, 분석, 할당량 설정을 지원하는 API 관리 시스템입니다. Endpoints는 Extensible Service Proxy(ESP) 및 Extensible Service Proxy V2(ESPv2)와 함께 작동하여 API 관리 기능을 제공합니다. Endpoints, ESP, ESPv2에 대한 자세한 내용은 엔드포인트 정보를 참조하세요.
Endpoints는 REST API를 정의하는 업계 표준인 OpenAPI 사양(이전 Swagger 사양) 버전 2를 지원합니다. OpenAPI 사양에 대해 잘 모르는 경우 OpenAPI 개요를 참조하세요.
이 문서에서는 OpenAPI에 Endpoints를 사용하는 방법을 보여줍니다. 다른 Endpoints 옵션에 대한 문서는 모든 Endpoints 문서를 참조하세요.
시작하려면 다음과 같은 순서에 따라 문서를 확인하는 것이 좋습니다.
Endpoints 기능 작동을 확인하려면 Cloud Endpoints 빠른 시작을 참조하세요. 이 문서에서는 스크립트를 사용하여 App Engine 가변형 환경에 샘플 API를 배포합니다.
이제 API에 사용할 컴퓨팅 플랫폼을 결정해야 합니다. 컴퓨팅 옵션 선택과 아래의 지원되는 컴퓨팅 플랫폼 섹션은 플랫폼을 결정하는 데 도움이 됩니다.
API의 백엔드를 결정했으면 선호하는 컴퓨팅 플랫폼의 가이드를 살펴봅니다.
지원되는 컴퓨팅 플랫폼
OpenAPI용 엔드포인트는 API 관리를 위해 ESP 또는 ESPv2를 사용합니다. ESP와 ESPv2는 오픈소스 프로젝트이며 다음과 같은 방법으로 제공됩니다.
- Artifact Registry의 컨테이너
- 현재 ESP Docker 이미지는 ESP 출시 노트를 참조하세요.
- 현재 ESPv2 Docker 이미지는 ESPv2 출시 노트를 참조하세요.
- GitHub의 소스 코드.
- ESP 구축에 대한 자세한 내용은 ESP README를 참조하세요.
- ESPv2 빌드에 대한 자세한 내용은 ESPv2 리드미를 참조하세요.
다음에서 ESP 컨테이너를 실행할 수 있습니다.
- App Engine 가변형 환경
- Compute Engine
- Kubernetes(Google Kubernetes Engine 포함)
- Linux, macOS 컴퓨터 또는 다른 플랫폼
다음에서 ESPv2 컨테이너를 실행할 수 있습니다.
- App Engine
- Cloud Run 함수
- Cloud Run
- Knative serving
- GKE
- Compute Engine
- Kubernetes
자세한 내용은 Cloud Endpoints 정보를 참조하세요.
App Engine 가변형 환경에서는 app.yaml 파일에 몇 줄만 추가하면 ESP가 자동으로 배포됩니다. 자세한 내용은 API 및 ESP 배포를 참조하세요. ESPv2는 App Engine 가변형 환경을 지원하지 않습니다.
App Engine 표준 1세대 환경의 경우 Endpoints 프레임워크를 사용해야 합니다. 대신 위의 컴퓨팅 옵션 중 하나에 컨테이너를 배포하는 경우에는 App Engine 표준 런타임 세대 중 하나에 프록시할 수 있습니다.