Rust gRPC with Tonic

데이터베이스, 운영체제, 커널과 시스템·2025년 11월 2일

Rust grpc tonic

Rust 에서 gRPC 해보기

오늘의 질문:

러스트에서 gRPC를 사용하려면 어떻게 해야 할까?

오늘의 목표:

러스트로 간단한 gRPC 서버 클라이언트 만들기

오늘의 참고 자료

Tonic makes gRPC in Rust stupidly simple
- https://www.youtube.com/watch?v=kerKXChDmsE&t=7s
- https://github.com/dreamsofcode-io/grpcalculator-rs
- https://github.com/dreamsofcode-io/grpcalculator-web

나온지 1-2년 정도 된 따끈한 영상이라서 그런지 여전히 잘 돌아간다.

영상을 따라한다고 바로 돌아가는 것은 아니고, GitHub 패치가 되어 있어 레포를 클론하면 바로 동작한다.

proto

syntax = "proto3";

package calculator;

service Calculator {
  rpc Add(CalculationRequest) returns (CalculationResponse);
  rpc Divide(CalculationRequest) returns (CalculationResponse);
}

message CalculationRequest {
  int64 a = 1;
  int64 b = 2;
}

message CalculationResponse { int64 result = 1; }

service Admin {
  rpc GetRequestCount(GetCountRequest) returns (CounterResponse);
}

message GetCountRequest {}

message CounterResponse { uint64 count = 1; }

위와 같이 간단한 calculator proto 파일을 정의한다.

Calculator 서비스는 2개의 메서드가 있는데

64비트 정수 a, b를 포함하는 CalculationRequest를 인자로 받고
int64 정수 반환 값 한 개로 이루어진 CalcualtionResponse를 반환한다.

여기까지는 gRPC를 사용할 때 언어 무관하게 공통적으로 셋업해주어야 하는 부분이다.

build.rs

use std::error::Error;
use std::{env, path::PathBuf};

fn main() -> Result<(), Box<dyn Error>> {
    let out_dir = PathBuf::from(env::var("OUT_DIR").unwrap());

    tonic_build::configure()
        .file_descriptor_set_path(out_dir.join("calculator_descriptor.bin"))
        .compile(&["proto/calculator.proto"], &["proto"])?;

    tonic_build::compile_protos("proto/calculator.proto")?;

    Ok(())
}

# Cargo.toml
[build-dependencies]
tonic-build = "0.11"

다른 cargo 프로젝트와 조금 다른 점이 있다면, 빌드를 하는 과정에 protoc이라는 외부 디펜던시를 사용하는 과정이 포함된다는 것이다.

따라서 cargo build 만으로 해결되는 것이 아니라, 따로 해당 protoc을 실행시켜 proto 파일을 컴파일하는 과정을 기술한 build.rs 또한 추가해야 한다. tonic_build 라는 모듈에서 이를 쉽게 해줄 수 있는 api를 제공한다.

gRPC Client

use proto::calculator_client::CalculatorClient;
use std::error::Error;

pub mod proto {
    tonic::include_proto!("calculator");
}

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let url = "http://[::1]:50051";
    let mut client = CalculatorClient::connect(url).await?;

    let req = proto::CalculationRequest { a: 4, b: 5 };
    let request = tonic::Request::new(req);

    let response = client.add(request).await?;

    println!("Response: {:?}", response.get_ref().result);

    Ok(())
}