gRPC 튜토리얼 통합 개념서 (MANUSCRIPT)

본 문서는 grpccanary 프로젝트의 전반적인 학습 경로와 각 단계별 통신 규약의 입문 배경을 설명하는 **통합 가이드북(GENERAL)**입니다.

각 장의 기초 개념을 습득한 후, 연결된 심화 학습 가이드를 통해 구체적인 코드 분석과 실습 가이드를 학습하실 수 있습니다.

🧭 학습 로드맵 및 가이드 바로가기

단계	실습 주제	심화 학습 가이드 링크
1단계	JSON 데이터 다루기	JSON 상세 가이드 (JSON.md)
2단계	HTTP & Gin 웹 서버	HTTP 상세 가이드 (HTTP.md)
3단계	gRPC 통신 구현	gRPC 상세 가이드 (GRPC.md)

1. JSON이란?

JSON(JavaScript Object Notation)은 데이터를 구조화하여 전송하기 위해 널리 사용되는 가볍고 읽기 쉬운 텍스트 기반의 데이터 포맷입니다. 대부분의 현대 프로그래밍 언어에서 기본적으로 지원하며, 특히 HTTP 기반 REST API의 데이터 교환 규격으로 오랫동안 사랑받아 왔습니다.

👉 1단계: JSON 데이터 다루기 상세 가이드 (JSON.md)

2. HTTP란?

HTTP(Hypertext Transfer Protocol)는 웹 브라우저와 웹 서버 간에 데이터를 주고받기 위한 통신 프로토콜입니다.

`gin-gonic`을 이용한 http 서버 구현하기

Go 언어에서는 전통적인 net/http 표준 라이브러리 외에도, 성능이 뛰어나고 라우팅 기능이 강력한 gin-gonic/gin 프레임워크를 널리 활용하여 RESTful 웹 API 서버를 구축합니다.

👉 2단계: HTTP & Gin 웹 서버 상세 가이드 (HTTP.md)

3. gRPC란?

Go 언어에서 gRPC를 어떻게 활용하는지 전반적으로 살펴보겠습니다.

gRPC가 필요한 이유: 어느 개발팀의 이야기

어느 날, 성장하는 스타트업의 백엔드 개발자 민우는 골치 아픈 버그를 마주했습니다. 서비스가 마이크로서비스 아키텍처(MSA)로 전환되면서, 회원 서비스(Go)와 주문 서비스(Python)가 서로 HTTP/JSON API로 통신하기 시작했는데, 최근 회원 서비스의 응답 필드 이름이 user_id에서 userId로 변경되면서 주문 서비스가 마비된 것입니다.

"사전 공유가 누락되었네요. 죄송합니다..." 회원 담당 팀원의 사과로 버그는 금방 고쳐졌지만, 민우는 근본적인 질문을 던지게 되었습니다. '왜 서비스 간의 통신 규칙(계약)을 코드 레벨에서 강제할 수 없을까?'

REST와 JSON은 단순하고 사람이 읽기 쉽다는 훌륭한 장점이 있어 인터넷망을 통한 클라이언트-서버 통신에 널리 쓰입니다. 하지만 대규모 마이크로서비스 환경에서 시스템 내부의 서비스 간 통신(Internal RPC)용으로는 다음과 같은 한계를 드러내곤 합니다:

느슨한 계약(Loose Contract): API 스펙 문서가 최신화되지 않으면 언제든 타입 오류나 필드 누락으로 인한 런타임 에러가 발생할 수 있습니다.
비효율적인 직렬화: 텍스트 기반의 JSON 데이터는 컴퓨터가 처리하기에 너무 무겁고, 네트워크 대역폭도 많이 차지합니다.
반복되는 클라이언트 코드 작성: 파트너 서비스가 고유한 API를 제공할 때마다, 이를 호출하기 위한 HTTP 클라이언트 패키지 코드를 다국어별로 매번 새로 작성해야 합니다.

이러한 문제들을 해결하기 위해 구글은 gRPC를 개발했습니다. gRPC는 다음과 같은 차별점을 통해 민우가 겪었던 어려움을 해결해 줍니다:

프로토콜 버퍼(Protobuf) 기반의 강력한 스키마 계약: .proto 파일 하나로 서비스 통신 규약을 선언하고, 이를 컴파일하여 여러 프로그래밍 언어의 구체적인 클라이언트/서버 코드를 자동으로 생성합니다. 즉, 컴파일 단계에서 스키마 계약 불일치 오류를 차단합니다.
바이너리 프로토콜: 텍스트가 아닌 이진 데이터 형식을 사용하여 통신 속도가 JSON 방식에 비해 훨씬 빠르고 가볍습니다.
HTTP/2 기반: 하나의 커넥션을 다중화(Multiplexing)하여 사용하므로 네트워크 리소스 효율성이 매우 높습니다.

민우가 겪은 문제는 서비스 몇 개가 통신하는 MSA 환경에서도 발생했지만, 다수의 IoT 디바이스와 지능형 에이전트가 실시간으로 데이터를 주고받는 AIoT 멀티 에이전트 환경에서는 계약 불일치와 직렬화 비용의 영향이 훨씬 크게 증폭됩니다. 본 프로젝트가 gRPC를 사전 학습 주제로 채택한 이유도 여기에 있습니다.

실제 gRPC 통신의 기술적 개념 요소(장단점, 프로토콜 버퍼) 및 소스코드 구현체 컴파일과 서버/클라이언트 개발 실습에 관한 상세 내용은 다른 페이지에서 나누어 다룹니다.

👉 3단계: gRPC 통신 구현 상세 가이드 (GRPC.md)

5.0 KiB Raw Permalink Blame History