시스템에서 구성 요소들은 어떻게 통신하나요 (API)?

Question

Accepted Answer

시스템에서 구성 요소(서비스, 클라이언트)는 **API**와 다양한 프로토콜 — 동기(REST, gRPC)와 비동기(메시징/큐) — 를 통해 통신합니다. 구성 요소들이 어떻게 통신하는지 이해하는 것은 여러 부분으로 이루어진 시스템을 설계하는 데 근본적입니다.

## 동기 통신 (요청/응답)

```text
호출자가 응답을 기다림 (블로킹):
  REST (HTTP) → 가장 흔함; HTTP(JSON)로 리소스 → 단순, 어디서나, 웹 친화적
  gRPC → 고성능 RPC (바이너리, HTTP/2) → 빠르고 타입 있음; 내부 서비스에 적합
  GraphQL → 유연한 쿼리 (클라이언트가 필요한 것만 정확히 요청)
→ 적합: 호출자가 지금 답이 필요한 직접 요청/응답
```

## 비동기 통신 (메시징)

```text
호출자가 기다리지 않음 (디커플링, 논블로킹):
  메시지 큐 (RabbitMQ, SQS) → 메시지 전송; 컨슈머가 나중에 처리
  이벤트 스트리밍 (Kafka) → 이벤트 발행; 컨슈머가 반응
  PUB/SUB → 구독자에게 이벤트 브로드캐스트
→ 적합: 디커플링, 백그라운드 작업, 스파이크 처리, 이벤트 기반 시스템
  ✓ 복원력 (큐 버퍼), 확장성, 디커플링  ✗ 더 복잡함, eventual consistency
```

## 선택과 고려 사항

```text
동기 → 호출자가 즉각적인 응답이 필요할 때; 더 단순한 요청/응답
비동기 → 디커플링, 복원력, 백그라운드 처리가 중요할 때 (블로킹 금지)
→ 또한: API 설계(명확한 계약), 버저닝, 오류 처리, 타임아웃/재시도,
  인증, rate limiting → 구성 요소 간 견고한 통신
```

## 왜 중요한가

API를 통해 구성 요소들이 어떻게 통신하는지 이해하는 것은 기초적입니다. **시스템은 통신해야 하는 여러 부분으로 이루어지므로** 통신을 이해하는 것이 그것들을 설계하는 데 필수적이기 때문입니다.

시스템은 상호작용하는 서비스와 클라이언트로 구성되며, 그들이 어떻게 통신하는지는 시스템 디자인의 근본적인 측면입니다.

**동기 통신**(호출자가 기다리는 요청/응답) — **REST**(어디서나 쓰이는 HTTP/JSON 접근법), **gRPC**(내부 서비스를 위한 고성능 RPC), GraphQL(유연한 쿼리) — 을 이해하면 구성 요소들이 답을 기대하며 직접 호출하는 흔한 방식을 다룹니다.

**비동기 통신**(디커플링, 논블로킹) — **메시지 큐**(나중에 처리할 메시지 전송), **이벤트 스트리밍**(Kafka), pub/sub — 을 이해하는 것도 똑같이 중요합니다. 이는 **디커플링, 복원력(큐가 부하를 버퍼링), 확장성, 이벤트 기반 시스템**을 가능하게 하며, 그 대가로 더 많은 복잡성과 eventual consistency를 갖습니다.

**동기 vs 비동기 구분과 각각을 언제 쓸지** — 호출자가 즉각적 응답이 필요하면 동기, 디커플링·복원력·백그라운드 처리가 중요하면 비동기 — 를 이해하는 것은 시스템의 특성에 큰 영향을 미치는 핵심 디자인 고려사항입니다.

추가 고려사항(명확한 API 계약, 버저닝, 오류 처리, 타임아웃/재시도, 인증, rate limiting)을 이해하는 것은 견고한 통신 설계를 반영합니다.

시스템은 통신하는 부분들로 구성되고 그들이 어떻게 통신하는지(동기 vs 비동기, 프로토콜, 디자인 고려사항)가 시스템을 근본적으로 형성하며, 구성 요소 통신을 이해하는 것이 다중 구성 요소 시스템 설계에 필수적이므로, API를 통한 구성 요소 통신을 이해하는 것은 필수적이고 기초적인 시스템 디자인 지식입니다 — 여러 상호작용하는 부분으로 이루어진 시스템 설계에 근본적이고, 구성 요소들을 연결하는 동기·비동기 통신을 다루며, 오늘날 흔한 분산·서비스 기반 시스템을 설계하는 데 중심적입니다.