grpc 골랭 배포

gRPC는 Golang을 포함한 여러 언어를 지원하는 Google의 오픈소스 고성능 RPC(원격 프로시저 호출) 프레임워크입니다. Golang에서 gRPC 코드는 작성 및 사용이 매우 간단하지만 실제로 배포할 때 몇 가지 문제가 발생할 수 있습니다.

이 글에서는 Golang에서 gRPC를 사용하고 서버에 배포하는 방법을 소개합니다.

1. Install gRPC

Golang에서는 gRPC 및 관련 protobuf 라이브러리를 설치해야 합니다. 다음 명령을 사용하여 gRPC 및 protobuf 라이브러리를 설치할 수 있습니다.

$ go get -u google.golang.org/grpc
$ go get -u github.com/golang/protobuf/{proto,protoc-gen-go}

2. Proto 파일 정의

gRPC에서는 원하는 서비스를 설명하기 위해 proto 파일을 정의해야 합니다. 예를 들어 메시지를 수락하고 이를 클라이언트에 반환하는 Echo 서비스를 정의할 수 있습니다.

다음은 간단한 Echo 서비스를 위한 proto 파일의 예입니다.

syntax = "proto3";

option go_package = "echo";

service EchoService {
  rpc Echo (EchoMessage) returns (EchoMessage);
}

message EchoMessage {
  string message = 1;
}

이 예에서는 메시지 문자열을 포함하는 EchoMessage 메시지 유형과 수락하는 Echo 메서드가 있는 Echo 서비스를 정의합니다. EchoMessage 메시지를 전송하고 해당 메시지를 응답으로 반환합니다.

3. Golang 코드 생성

proto 파일을 정의하고 나면 protobuf 컴파일러를 사용하여 해당 Golang 코드를 생성할 수 있습니다. Golang 코드를 생성하려면 다음 명령을 실행해야 합니다.

$ protoc --go_out=. echo.proto

그러면 Echo 서비스용 코드가 포함된 echo.pb.go라는 파일이 생성됩니다.

4. 서비스 구현

다음으로 Echo 서비스를 구현해야 합니다. Echo 서비스에서 EchoMessage 메시지를 수신하고 해당 메시지를 클라이언트에 반환하려면 Echo 메서드를 구현해야 합니다.

다음은 간단한 Echo 서비스 구현 예입니다.

type server struct{}

func (s *server) Echo(ctx context.Context, message *EchoMessage) (*EchoMessage, error) {
  return &EchoMessage{
    Message: message.Message,
  }, nil
}

func main() {
  s := grpc.NewServer()
  RegisterEchoServiceServer(s, &server{})
  lis, err := net.Listen("tcp", ":50051")
  if err != nil {
    log.Fatalf("failed to listen: %v", err)
  }
  if err := s.Serve(lis); err != nil {
    log.Fatalf("failed to serve: %v", err)
  }
}

이 예에서는 Echo 메소드가 포함된 서버 유형을 구현합니다. 클라이언트가 Echo 메서드를 호출하면 수신된 메시지가 반환됩니다.

또한 메인 함수에서 gRPC 서버를 생성하고 구현을 등록 함수 RegisterEchoServiceServer에 전달했습니다. 그런 다음 포트 50051에서 수신 대기를 시작하고 서버를 시작합니다.

5. 컴파일 및 배포

gRPC 서비스 구현을 완료한 후에는 이를 컴파일하여 서버에 배포해야 합니다. 다음 명령을 사용하여 코드를 컴파일할 수 있습니다.

$ go build .

이렇게 하면 서버에 배포할 수 있는 실행 파일이 생성됩니다. 서버에서 다음 명령을 실행하여 gRPC 서비스를 시작할 수 있습니다.

$ ./your-program

이 예에서 프로그램 이름은 "your-program"입니다. 프로그램을 실행하기 전에 서버가 포트 50051에 액세스할 수 있는지 확인해야 합니다.

6. 코드 테스트

배포를 완료한 후 gRPC 클라이언트를 사용하여 코드를 테스트할 수 있습니다. 다음 명령을 사용하여 gRPC 클라이언트를 설치할 수 있습니다.

$ go get -u google.golang.org/grpc/cmd/protoc-gen-go-grpc

gRPC 클라이언트를 사용하려면 연결을 만든 다음 해당 연결을 사용하여 Echo 서비스를 호출해야 합니다.

다음은 간단한 gRPC 클라이언트 예입니다.

func main() {
  conn, err := grpc.Dial(":50051", grpc.WithInsecure())
  if err != nil {
    log.Fatalf("did not connect: %v", err)
  }
  defer conn.Close()

  c := NewEchoServiceClient(conn)
  message := &EchoMessage{Message: "hello world"}
  res, err := c.Echo(context.Background(), message)
  if err != nil {
    log.Fatalf("echo failed: %v", err)
  }
  log.Printf("echo response: %s", res.Message)
}

이 예에서는 연결을 만든 다음 해당 연결을 사용하여 Echo 서비스를 호출합니다. EchoMessage 메시지를 전달한 다음 서버 응답을 인쇄하여 코드가 제대로 작동하는지 테스트했습니다.

7. 결론

gRPC는 효율적인 RPC 프레임워크이며 Golang에서 사용하기 매우 간단하지만 실제 배포 프로세스 중에 몇 가지 문제에 직면할 수 있습니다. 이 문서에서는 gRPC 및 관련 protobuf 라이브러리를 설치하는 방법, proto 파일을 정의하는 방법, Golang 코드를 생성하는 방법을 설명합니다. 또한 Echo 서비스를 구현하는 방법과 이를 서버에 배포하는 방법도 보여주었습니다. 마지막으로 gRPC 클라이언트를 사용하여 코드를 테스트하는 방법도 시연했습니다.

위 내용은 grpc 골랭 배포의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!