문제해결 개요

이 페이지는 일반적인 문제해결 정보와 추가 정보를 위한 다른 페이지 링크를 제공합니다.

Cloud Endpoints 구성 배포 시 오류

gcloud endpoints services deploy 명령어에서 오류 메시지가 표시되는 경우 오류 문제 해결에 대한 자세한 내용은 Endpoints 구성 배포 문제해결을 참조하세요.

API 백엔드 배포 시 오류

Google Cloud 백엔드에 대한 API 및 Extensible Service Proxy(ESP) 배포는 플랫폼에 종속됩니다. 자세한 내용은 다음 문제해결 가이드를 참조하세요.

응답 오류

API에 요청을 보낸 후 오류 응답을 받는 경우, 오류 문제해결에 대한 자세한 내용은 응답 오류 문제해결을 참조하세요.

필수 서비스 확인

필수 서비스 확인

Endpoints와 ESP를 사용하려면 최소한 다음 Google 서비스를 사용 설정해야 합니다.
이름 제목
servicemanagement.googleapis.com Service Management API
servicecontrol.googleapis.com Service Control API
endpoints.googleapis.com Google Cloud Endpoints

대부분의 경우 gcloud endpoints services deploy 명령어를 사용하여 이러한 필수 서비스를 사용 설정할 수 있습니다. 하지만 다음과 같은 경우에는 gcloud 명령어가 성공적으로 완료되더라도 필수 서비스가 사용 설정되지 않습니다.

  • Terraform과 같은 타사 애플리케이션을 사용하고 이러한 서비스를 포함하지 않은 경우

  • 이러한 서비스가 명시적으로 중지된 기존 Google Cloud 프로젝트에 Endpoints 구성을 배포한 경우

다음 명령어를 사용하여 필수 서비스가 사용 설정되어 있는지 확인합니다.

gcloud services list

필수 서비스가 나열되지 않으면 서비스를 사용 설정하세요.

gcloud services enable servicemanagement.googleapis.com
gcloud services enable servicecontrol.googleapis.com
gcloud services enable endpoints.googleapis.com

Endpoints 서비스도 사용 설정해야 합니다.

gcloud services enable ENDPOINTS_SERVICE_NAME

ENDPOINTS_SERVICE_NAME을 확인하려면 다음 중 하나를 수행합니다.

  • Endpoints 구성을 배포한 후 Cloud Console의 Endpoints 페이지로 이동합니다. 가능한 ENDPOINTS_SERVICE_NAME 목록이 서비스 이름 열 아래에 표시됩니다.

  • OpenAPI의 경우 ENDPOINTS_SERVICE_NAME은 OpenAPI 사양의 host 필드에 지정한 항목입니다. gRPC의 경우 ENDPOINTS_SERVICE_NAME은 gRPC 엔드포인트 구성의 name 필드에 지정한 항목입니다.

gcloud 명령어에 대한 자세한 내용은 gcloud 서비스를 참조하세요.

필수 권한 확인

Extensible Service Proxy를 실행하는 인스턴스에는 Service Management 및 ServiceControl을 호출할 수 있는 권한이 필요합니다.

디버그 정보 확인

디버그 세부정보 수준으로 Google Cloud CLI를 실행하면 디버깅에 도움이 됩니다.

gcloud --verbosity=debug COMMAND

이 명령어는 Google Cloud CLI가 오류의 상세 로그를 출력하도록 합니다. 실행 중인 명령어에 따라 서버의 요청과 응답 정보가 출력에 포함될 수 있습니다.

서비스 사용 설정

gcloud를 사용하여 서비스가 사용 설정되었는지 여부를 확인할 수 있습니다.

gcloud services list

특정 서비스의 구성을 표시하려면 다음 명령어를 사용합니다.

gcloud endpoints services describe SERVICE_NAME

프록시 OAuth는 실패했지만 요청은 통과

gRPC API 구성 파일에 OAuth 정의가 포함된 authentication 섹션이 있는지 확인합니다. 구성 파일 예시는 GitHub의 Bookstore 샘플에서 제공됩니다.

다음 단계