Code

[Google Cloud Platfrom] Google Cloud Endpoints

March 1, 2016

author:

[Google Cloud Platfrom] Google Cloud Endpoints

  • App의 API를 구성하기 쉽도록 제공하는 서비스
  • Remote Procedure Call(RPC)를 이용하여 작업을 진행할 수 있도록 구성.

사용

  • 2가지 방법이 존재
    • RPC의 message 클래스를 이용하는 방법.
    • RPC를 통하지 않고 직접 작업하는 방법.
    • 사용은 RPC를 통하지 않는 방법이 간단하긴하다.

예제

  1. appengine-endpoints-helloendpoints-python
    • RPC message 클래스를 이용하도록 되어있음.
    • 랩핑하는 것에 대한 내용이 포함.
  2. appengine-endpoints-angular-todos-python
    • RPC message 클래스를 사용하지 않음.
    • Angular.js를 이용하도록 예제가 되어있어서 확인해보면 될듯함.
  3. appengine-endpoints-tictactoe-python
    • 게임 예제로 보이나 아직 테스트해보지 않음.

필요 패키지

  • endpoints-proto-datastore
  • ProtoRPC 를 사용하지 않아도 된다고 함. 1
  • 지금은 NDB만 지원. 추후 DB지원은 모르겠음.
  • DB를 사용하려면 전부 분해하고 설정하는 것이 필요할 것으로 보임.

API 구성

  • /_ah/spi/.* URL은 app.yaml 파일에 하나만 가능함.
  • 여러 API를 사용하고 싶으면 main.py 에 일반 예제들처럼 API클래스를 생성하고 다음과 같이 설정해주면됨.
    # app.yaml
    - url: /_ah/spi/.*
      script: main.application
    
    # main.py
    application = endpoints.api_server([App1_api, App2_api, ...])
    
  • 하나의 API에 여러 클래스를 두고 싶다면 아래의 방법으로 구성
    # API를 종류별로 나눔 
    test_api_v1 = endpoints.api(name='test', version='v1.0')
    test1_api_v1 = endpoints.api(name='test1', version='v1.0')
    
    # API를 처리할 Class구성
    @test_api_v1.api_class(resource_name='hello')
    class Hello(remote.Service):
        pass
    
    @test_api_v1.api_class(resource_name='bye')
    class Bye(remote.Service):
        pass
    
    @test1_api_v1.api_class(resource_name='todo')
    class Todo(remote.Service):
        pass
    
    @test1_api_v1.api_class(resource_name='plan')
    class Plan(remote.Service):
        pass
    
    application = endpoints.api_server([Hello, Bye, Todo, Plan])
    

API 등록확인

  • project-id.appspot.com/_ah/api/explorer 로 접근하여 확인.
  • 업로드되어 표시되는 시간이 오래걸리니(최소 5분은 걸리는듯.) 올라갔는지 확인을 하려면 Google Developers Console에서 로그로 확인하면된다.
  • 올라갔다면 아래와 같이 표시된다.
    https://1-dot-project-id.appspot.com/_ah/api/[email protected] Saved
    https://1-dot-project-id.appspot.com/_ah/api/[email protected] Saved
    

  1. http://endpoints-proto-datastore.appspot.com/