GM 오락실
← 개인 공부 · Backend
STUDY NOTE · 개념 정리

MSA 기본 개념 정리: API Gateway, 서비스 디스커버리, 분산 트랜잭션과 Saga

Backend
MSA(마이크로서비스 아키텍처)는 애플리케이션을 독립적으로 배포할 수 있는 작은 서비스들로 나누고, 각 서비스가 자기 데이터베이스를 갖게 하는 구조다. 외부 요청은 API Gateway가 받아 서비스로 보내고, 서비스 위치는 서비스 디스커버리로 찾는다. 여러 서비스에 걸친 작업은 하나의 DB 트랜잭션으로 묶을 수 없으므로 Saga로 단계별 로컬 트랜잭션과 보상 트랜잭션을 조합한다.

1. 모놀리스 vs MSA

구분모놀리스MSA
배포 단위애플리케이션 전체서비스별
DB하나의 DB 공유서비스별 DB (Database per Service)
서비스 간 호출메서드 호출네트워크 호출 (HTTP, gRPC, 메시지)
트랜잭션DB 트랜잭션 하나로 처리분산 트랜잭션 문제 (Saga 등)
확장전체를 복제부하가 큰 서비스만 확장
장애 영향한 기능의 문제가 전체에 영향격리 가능하지만 연쇄 장애 대비 필요
운영 복잡도낮음높음 (배포, 모니터링, 추적, 네트워크)
적합초기 서비스, 작은 팀도메인이 크고 팀이 여러 개, 부분별 독립 배포가 중요할 때

MSA는 기술 문제보다 조직과 배포의 독립성을 위한 선택이다. 서비스를 나눴는데 배포를 늘 같이 해야 하거나 서로의 DB를 직접 조회한다면 "분산 모놀리스"가 되어 단점만 남는다.

2. 구성 요소

구성 요소역할예
API Gateway외부 요청의 단일 진입점. 라우팅, 인증, 요청 제한, CORS, 로깅Spring Cloud Gateway, Kong, 클라우드 API Gateway
서비스 디스커버리서비스 인스턴스의 위치(IP·포트)를 등록하고 찾기Eureka, Consul, 쿠버네티스 Service(DNS)
설정 관리환경별 설정을 서비스 밖에서 중앙 관리Spring Cloud Config, 쿠버네티스 ConfigMap·Secret
서킷 브레이커장애 서비스 호출을 빠르게 차단해 연쇄 장애 방지Resilience4j
메시지 브로커서비스 간 비동기 이벤트 전달Kafka, RabbitMQ
관측성분산 추적, 중앙 로그, 메트릭OpenTelemetry, Zipkin, ELK, Prometheus

3. API Gateway

클라이언트 → API Gateway ─┬→ /api/members/** → 회원 서비스
(인증, 로깅) ├→ /api/orders/** → 주문 서비스
└→ /api/products/** → 상품 서비스
  1. 클라이언트는 서비스가 몇 개인지, 어디 있는지 몰라도 된다.
  2. 인증 토큰 검증, 요청 제한 같은 공통 처리를 한 곳에서 한다. 게이트웨이가 검증한 사용자 정보를 헤더로 넘기고, 내부 서비스는 외부에서 직접 접근할 수 없게 막는다.
  3. 게이트웨이는 모든 요청이 거치므로 병목·단일 장애점이 되지 않게 여러 대로 운영하고, 비즈니스 로직은 넣지 않는다.

4. 서비스 디스커버리

서비스 인스턴스는 오토스케일링과 재배포로 IP가 계속 바뀐다. 그래서 주소를 설정 파일에 고정하지 않고 레지스트리에 등록하고 찾는다.

방식동작예
클라이언트 사이드호출하는 쪽이 레지스트리에서 인스턴스 목록을 받아 직접 하나를 골라 호출 (클라이언트 측 로드밸런싱)Eureka + Spring Cloud LoadBalancer
서버 사이드호출하는 쪽은 고정된 주소로 보내고, 로드밸런서·프록시가 인스턴스를 골라 전달쿠버네티스 Service, AWS ELB

쿠버네티스에서는 Service 이름이 DNS로 등록되고(order-service.default.svc.cluster.local), 준비된(readiness를 통과한) 파드로만 트래픽이 간다. 별도의 Eureka 없이 서버 사이드 디스커버리가 기본으로 제공된다.

5. 통신 방식

구분동기 (REST, gRPC)비동기 (메시지, 이벤트)
흐름요청하고 응답을 기다림이벤트를 발행하고 바로 진행
결합도호출 대상이 살아 있어야 함브로커만 살아 있으면 됨
일관성즉시 결과 확인최종적 일관성 (Eventual Consistency)
적합결과가 바로 필요한 조회, 검증주문 완료 후 알림·포인트 적립처럼 나중에 처리해도 되는 일

동기 호출이 길게 이어지면(A → B → C → D) 한 서비스의 지연이 전체 응답 시간과 가용성을 떨어뜨린다. 호출마다 타임아웃, 재시도(멱등한 요청만), 서킷 브레이커를 둔다.

6. 서킷 브레이커

상태동작
Closed (닫힘)정상. 호출을 그대로 보내고 실패율을 집계
Open (열림)실패율이 기준을 넘으면 일정 시간 동안 호출하지 않고 즉시 실패 또는 대체 응답(fallback)
Half-Open (반열림)대기 시간이 지나면 일부 호출만 보내 보고, 성공하면 Closed, 실패하면 다시 Open

7. 분산 트랜잭션 문제

모놀리스에서는 주문 생성, 결제, 재고 차감을 하나의 @Transactional로 묶으면 됐다. MSA에서는 각각 다른 서비스, 다른 DB라서 한 트랜잭션으로 묶을 수 없다.

방법방식문제
2PC (Two-Phase Commit)코디네이터가 모든 참여자에게 준비를 묻고(prepare), 모두 가능하면 커밋 지시참여자 모두가 락을 잡고 기다림, 코디네이터 장애 시 멈춤, 메시지 브로커·NoSQL 등 지원 안 하는 자원이 많음
Saga각 서비스가 로컬 트랜잭션을 커밋하고 다음 단계를 진행, 실패하면 앞 단계를 되돌리는 보상 트랜잭션 실행중간 상태가 잠시 보임, 보상 로직을 직접 설계해야 함

8. Saga: 코레오그래피 vs 오케스트레이션

구분코레오그래피 (Choreography)오케스트레이션 (Orchestration)
제어 방식각 서비스가 이벤트를 듣고 스스로 다음 일을 함중앙 오케스트레이터가 각 서비스에 명령
장점중앙 컴포넌트 없음, 단순한 흐름에 적합전체 흐름이 한 곳에 보임, 복잡한 흐름 관리 쉬움
단점단계가 많아지면 흐름 추적이 어렵고 순환 의존 위험오케스트레이터에 로직이 집중
  1. 주문 서비스: 주문을 대기 상태로 생성 → 주문생성됨 이벤트
  2. 결제 서비스: 결제 승인 → 결제완료됨 이벤트
  3. 재고 서비스: 재고 차감 시도 → 재고 부족이면 재고차감실패 이벤트
  4. 결제 서비스: 실패 이벤트를 받아 결제 취소(보상 트랜잭션)
  5. 주문 서비스: 주문을 취소 상태로 변경(보상 트랜잭션)

보상 트랜잭션은 DB 롤백이 아니라 반대 의미의 새 작업이다(결제 → 결제 취소). 그래서 "되돌릴 수 없는 작업"(메일 발송 등)은 가능한 한 마지막 단계에 둔다. 메시지는 중복 전달될 수 있으므로 각 단계는 멱등하게 만든다.

9. Transactional Outbox

"DB에 주문 저장"과 "이벤트 발행"은 서로 다른 시스템이라, 저장은 됐는데 발행이 실패하거나 그 반대가 생길 수 있다. Outbox 패턴은 이벤트를 같은 DB 트랜잭션으로 outbox 테이블에 함께 저장하고, 별도 프로세스(폴링 또는 CDC)가 이 테이블을 읽어 브로커로 발행한다. 저장과 이벤트 기록이 함께 커밋되거나 함께 롤백되므로 유실되지 않는다.

10. 실제로 어떻게 적용되나

  1. 서비스 경계 나누기: 기술 계층(컨트롤러, DB)이 아니라 업무 단위(회원, 주문, 상품, 알림)로 나눈다. 함께 자주 바뀌는 기능은 같은 서비스에 둔다.
  2. 다른 서비스 데이터가 필요할 때: 상대 DB를 직접 조회하지 않는다. API로 묻거나, 이벤트로 필요한 데이터 사본을 내 쪽에 유지한다(예: 주문 서비스가 주문 시점의 상품명·가격을 저장).
  3. 분산 추적: 한 요청이 여러 서비스를 거치면 로그가 흩어진다. 게이트웨이에서 trace ID를 만들어 헤더로 전파하고 모든 로그에 남기면 한 요청의 흐름을 이어서 볼 수 있다.
  4. 알림 서비스 분리: 알림톡·메일 발송처럼 실패해도 주문 자체는 성공해야 하는 일은 이벤트 기반 비동기로 분리하기 좋은 첫 후보다.

11. 면접 질문으로 정리

  1. Q. MSA의 장단점은? 서비스별 독립 배포와 확장, 장애 격리, 팀 자율성이 장점이다. 네트워크 호출 비용, 분산 트랜잭션, 운영·모니터링 복잡도 증가가 단점이다.
  2. Q. API Gateway의 역할은? 외부 요청의 단일 진입점으로 라우팅, 인증·인가, 요청 제한, 로깅 같은 공통 기능을 처리하고 내부 서비스 구조를 클라이언트로부터 숨긴다.
  3. Q. 서비스 디스커버리가 필요한 이유는? 서비스 인스턴스가 자동 확장과 재배포로 수시로 바뀌므로 고정 주소 대신 레지스트리에 등록하고 이름으로 찾아야 하기 때문이다.
  4. Q. MSA에서 분산 트랜잭션은 어떻게 처리하나? 2PC는 가용성과 성능 문제가 커서 보통 Saga를 쓴다. 각 서비스가 로컬 트랜잭션을 커밋하고, 실패 시 이전 단계를 보상 트랜잭션으로 되돌린다.
  5. Q. Saga의 코레오그래피와 오케스트레이션의 차이는? 코레오그래피는 서비스들이 이벤트를 주고받으며 스스로 다음 단계를 진행하고, 오케스트레이션은 중앙 오케스트레이터가 각 단계를 지시한다.
Gunmo Lee
since 2021.07
MSA 기본 개념 정리: API Gateway, 서비스 디스커버리, 분산 트랜잭션과 Saga | GM 오락실