마이크로서비스 환경에서 HTTP 요청을 라우팅하고 필터링하는 Spring Framework 및 Spring Boot 기반 API 게이트웨이입니다.
grpc-ecosystem/grpc-spring
@GrpcService와 @GrpcClient 같은 어노테이션으로 gRPC 서버와 클라이언트를 실행하는 Spring Boot 스타터로, 채널이나 서버를 직접 설정할 필요가 없습니다.
- 스타
- 3,709
- 포크
- 853
- 열린 이슈
- 172
- 마지막 커밋
- 그저께
어떤 프로젝트인가요?
grpc-spring은 gRPC용 Spring Boot 스타터입니다. @GrpcService가 붙은 클래스에서 gRPC 서버를 자동으로 구성하고 시작하며, @GrpcClient가 붙은 필드에 gRPC 채널과 stub을 생성하고 관리합니다. 서버와 클라이언트 설정은 grpc.server 및 grpc.client 접두사를 사용하는 Spring의 표준 프로퍼티 방식으로 지정합니다.
grpc-java를 기반으로 하며, 서버 측에서는 BindableService 기반 구현체라면 무엇이든 사용할 수 있습니다. Reactive gRPC나 grpc-kotlin 같은 다른 형태의 클라이언트 지원에는 사용자 정의 StubFactory 구현이 필요합니다. 또한 Spring Security, Spring Cloud 서비스 디스커버리(Consul, Eureka, Nacos), Brave를 통한 Spring Sleuth 트레이싱, 전역 및 사용자 정의 인터셉터, micrometer/actuator 메트릭과 통합됩니다.
통합 스타터와 함께 서버 및 클라이언트용 스타터도 별도로 배포되며, 일부 bean을 직접 구성하면 Spring Boot 없이도 사용할 수 있습니다.
핵심 기능
- 01@GrpcService 구현체를 기반으로 gRPC 서버를 자동 실행합니다.
- 02@GrpcClient를 사용해 gRPC 채널과 stub을 생성하고 관리합니다.
- 03Consul, Eureka, Nacos 같은 Spring Cloud 디스커버리와 통합됩니다.
- 04전역 및 사용자 정의 gRPC 서버·클라이언트 인터셉터를 지원합니다.
- 05micrometer와 actuator를 통해 메트릭을 제공합니다.
활용 사례
- 기존 Spring Boot 애플리케이션에 gRPC 서비스를 추가합니다.
- 서비스 디스커버리로 찾은 주소를 사용해 Spring 코드에서 다른 gRPC 마이크로서비스를 호출합니다.
- Spring Security나 인터셉터를 통해 gRPC 호출에 인증 또는 트레이싱을 추가합니다.
포함된 컬렉션
토픽
자주 묻는 질문
- grpc-spring은(는) 무엇인가요?
- @GrpcService와 @GrpcClient 같은 어노테이션으로 gRPC 서버와 클라이언트를 실행하는 Spring Boot 스타터로, 채널이나 서버를 직접 설정할 필요가 없습니다. grpc-spring은 gRPC용 Spring Boot 스타터입니다. @GrpcService가 붙은 클래스에서 gRPC 서버를 자동으로 구성하고 시작하며, @GrpcClient가 붙은 필드에 gRPC 채널과 stub을 생성하고 관리합니다. 서버와 클라이언트 설정은 grpc.server 및 grpc.client 접두사를 사용하는 Spring의 표준 프로퍼티 방식으로 지정합니다.
- grpc-spring은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- grpc-spring은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- grpc-spring은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. grpc-spring의 마지막 커밋은 2026년 11월 4일입니다.
- grpc-spring은(는) 어디에 사용할 수 있나요?
- 기존 Spring Boot 애플리케이션에 gRPC 서비스를 추가합니다. 서비스 디스커버리로 찾은 주소를 사용해 Spring 코드에서 다른 gRPC 마이크로서비스를 호출합니다. Spring Security나 인터셉터를 통해 gRPC 호출에 인증 또는 트레이싱을 추가합니다.
- grpc-spring은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/grpc-ecosystem/grpc-spring
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
Spring Cloud 인터페이스를 Kubernetes 기반으로 구현해 Spring Cloud 앱에서 Kubernetes를 서비스 디스커버리와 설정에 활용할 수 있습니다.
서비스 통신, 디스커버리, 트래픽 관리를 위한 RPC 및 마이크로서비스 프레임워크 Apache Dubbo의 Java 구현체입니다.
Spring Cloud 애플리케이션을 Tencent의 Polaris와 연동해 서비스 검색 및 거버넌스를 제공하는 Spring Cloud 구현체입니다.
Actuator 엔드포인트를 통해 Spring Boot 애플리케이션을 모니터링하고 관리하는 웹 기반 관리 대시보드입니다.
서비스 프록시, 프로토콜 변환, API 거버넌스를 지원하며 플러그인 체인과 중앙 Admin 콘솔을 갖춘 Java 기반 API 게이트웨이입니다.