python으로 gRPC / tools 설치 및 작동시키기

gRPC

구글이 최초로 개발한 오픈 소스 원격 프로시저 호출 시스템 

( 자세한 설명 - https://grpc.io/docs/guides/ )

 

 

 

gRPC 설치 방법

1. cmd 창 열기

2. version이 9.0.1 이상이어야 하므로 업그레이드

python -m pip install --upgrade pip

3. gRPC 설치

# 방법 1
python -m pip install grpcio

# 방법 2 - 시스템 전체에 설치하려면
sudo python -m pip install grpcio

* El Capitan OSX에서 다음과 같은 오류가 발생할 수 있다.
OSError: [Errno 1] Operation not permitted: '/tmp/pip-qwTLbI-uninstall/System/Library/Frameworks/Python.framework/Versions/2.7/Extras/lib/python/six-1.4.1-py2.7.egg-info'

python -m pip install grpcio --ignore-installed

 

 

gRPC tools 설치 방법

Python의 gRPC tools에는 .proto 서비스 정의에서 protocol buffer compiler인 protoc와 서버 및 클라이언트 코드를 생성하기 위한 특수 플러그인이 포함된다.

python -m pip install grpcio-tools

 

예제 다운로드

git 키고 (git 없으면 먼저 다운로드 해야함)

# Clone the repository to get the example code:
git clone -b v1.22.0 https://github.com/grpc/grpc
# Navigate to the "hello, world" Python example:
cd grpc/examples/python/helloworld

* git 설명 - 블로그

* git 설치 방법 - 블로그

 

 

 

gRPC application 작동시키기

디렉토리 helloworld가 있는 곳으로 cd

 

1. cmd에서 다음 코드로 server 실행시키고

python greeter_server.py

 

2. 다른 cmd에서 다음 코드로 client 실행시킴

python greeter_client.py

Greeter client received: Hello, you!

위 문구가 출력되면 정상적으로 작동 되는 것이다.

 

 

 

Update a gRPC service

examples/protos/helloworld.proto에 있는 helloworld.proto파일에 SayHelloAgain method를 추가한다.

service Greeter {
  // Sends a greeting
  rpc SayHello (HelloRequest) returns (HelloReply) {}
  // Sends another greeting
  rpc SayHelloAgain (HelloRequest) returns (HelloReply) {}
}

저장하고

다시 examples/python/helloworld directory로 이동한 후, 

 

 

Generate gRPC code

새로운 서비스 정의를 사용하기위해 애플리케이션에서 사용하는 gRPC코드를 업데이트

 

helloworld.proto 파일이 있는 위치로 cd

python -m grpc_tools.protoc -I../../protos --python_out=. --grpc_python_out=. ../../protos/helloworld.proto

생성된 요청 및 응답 클래스가 포함된 helloworld_pb2.py와 생성된 클라이언트 및 서버 클래스가 포함된 helloworld_pb2_grpc.py가 (재)생성 된다.

 

 

Update and run the application

이제 새로 생성된 서버 및 클라이언트 코드가 있지만 예제 응용 프로그램의 사람이 작성한 부분에서 새 메소드를 구현하고 호출해야한다.

 

Update the server

examples/python/helloworld에 있는 greeter_server.py에 SayHelloAgain method 추가

class Greeter(helloworld_pb2_grpc.GreeterServicer):

  def SayHello(self, request, context):
    return helloworld_pb2.HelloReply(message='Hello, %s!' % request.name)

  def SayHelloAgain(self, request, context):
    return helloworld_pb2.HelloReply(message='Hello again, %s!' % request.name)
...

 

Update the client

examples/python/helloworld에 있는 greeter_client.py에서 def run() 수정

def run():
  channel = grpc.insecure_channel('localhost:50051')
  stub = helloworld_pb2_grpc.GreeterStub(channel)
  response = stub.SayHello(helloworld_pb2.HelloRequest(name='you'))
  print("Greeter client received: " + response.message)
  response = stub.SayHelloAgain(helloworld_pb2.HelloRequest(name='you'))
  print("Greeter client received: " + response.message)

 

이제 다시 server와 client (위에 소개한대로)를 작동시키면

다음과 같이 출력된다

 

 

 

 

 

 

 

 

 

출처: https://grpc.io/docs/quickstart/python/