JSCODE Logo
JSCODE 박재성JSCODE 제이온JSCODE 시니
과외유튜브블로그후기
완강 후기 이벤트블로그 리뷰 이벤트AWS SAA 합격 후기 이벤트
회사명 : JSCODE대표 : 박재성사업자 등록번호 : 244-22-01557통신판매업 : 제 2023-인천미추홀-0381 호

서울특별시 구로구 경인로 20가길 11(오류동, 아델리아)

Copyright ⓒ 2026 JSCODE - 최상위 현업 개발자들의 프로그래밍 교육 All rights reserved.

이용약관개인정보처리방침

비전공자도 이해할 수 있는 MSA 입문/실전

MSA 기본 개념

MSA를 왜 배워야할까?
MSA(Microservice Architecture)란?
MSA의 핵심 특징 / MSA의 독보적인 장점
언제 MSA를 도입하는 게 적절할까?
많은 사람들이 MSA가 어렵다고 착각하는 이유
MSA인지 아닌지를 판단하는 기준
MSA를 쉽고 빠르게 배우는 방법

기본적인 마이크로서비스 구축해보기

MSA 프로젝트 요구사항 및 설계
[실습] 각 Microservice에 해당하는 DB 서버 띄우기
[실습] User Microservice 만들기
[실습] Board Microservice 만들기
구현한 MSA 프로젝트를 잘 구현했는 지 전체적으로 검토하기

데이터 조회 API 구현하기 (마이크로서비스 간에 REST API로 통신)

데이터 조회 기능 구현 방식 (모놀리식 vs MSA)
[실습] 다른 마이크로서비스가 사용할 ‘사용자 조회 API’ 만들기
[실습] 특정 게시글 조회 API 만들기
특정 서비스가 장애났을 때, 장애가 전파되지 않게 막는 방법
[실습] 특정 서비스가 장애났을 때, 장애가 전파되지 않게 방어 코드 작성하기
[실습] 게시글 전체 조회 API 만들기 - 1
[실습] 게시글 전체 조회 API 만들기 - 2

데이터 쓰기 API 구현하기 (마이크로서비스 간에 REST API로 통신)

[실습] Point Microservice 만들기 - 1
[실습] Point Microservice 만들기 - 2
[실습] 회원 가입하면 포인트가 적립되도록 만들기
[실습] 사용자 활동 점수 적립 API 만들기
[실습] ‘포인트 차감 → 게시글 작성→ 활동 점수 적립’ 순으로 로직이 처리되도록 만들기

MSA 환경에서 트랜잭션 관리하기

게시글 작성 API 로직 수행 중, 중간에 에러가 발생하면 어떻게 될까?
MSA 환경에서의 트랜잭션 처리 방법
Saga 패턴이란? / 보상 트랜잭션이란?
[실습] 게시글 작성 API에 Saga 패턴 적용시키기 - 1
[실습] 게시글 작성 API에 Saga 패턴 적용시키기 - 2
Eventual Consistency(최종적 일관성)이란?
[참고] Saga 패턴을 구현할 때 고려해야 할 요소 (멱등성, 동시성 이슈 등)

데이터 쓰기 API 구현하기 (마이크로서비스 간에 메시징 기반으로 통신)

MSA 환경에서 언제 메시징 기반(비동기 방식)으로 통신하면 좋을까?
어떻게 구현할 지 설계하기
[실습] 게시글 서비스에서 Kafka로 ‘게시글 작성 완료 이벤트’ 발행하기
[실습] 사용자 서비스에서 Kafka로부터 ‘게시글 작성 완료 이벤트’ 구독하기
[실습] 잘 작동하는 지 테스트하기

‘메시징 기반의 데이터 동기화 방식’으로 데이터 조회 최적화하기

‘데이터 동기화’를 활용한 게시글 조회 API 최적화하기
[실습] 사용자 서비스에서 Kafka로 ‘회원가입 완료 이벤트’ 발행하기
[실습] 게시글 서비스에서 Kafka로부터 ‘회원가입 완료 이벤트’ 구독하기
[실습] 잘 작동하는 지 테스트하기
[실습] 게시글 조회 로직 최적화하기 (

API Gateway를 활용해 클라이언트의 요청을 적절한 서버로 전달하기

API Gateway란?
[실습] Spring Cloud Gateway 셋팅하기 / 라우팅 설정하기
[실습] ‘외부용 API’와 ‘마이크로서비스간 통신용 API’ 구분하기
[실습] API Gateway를 활용해 클라이언트가 접근할 API 제한하기

API Gateway를 활용해 JWT 인증 로직 구현하기

MSA에서 ‘인증 로직’ 구현하는 방법
[실습] 사용자 서비스에 로그인 API 구현하기
[실습] API Gateway에 JWT 인증 로직 구현하기 (
[실습] 게시글 작성 로직 수정하기

마무리

MSA는 꼭 쿠버네티스로 배포해야 할까?
[미션] AWS에 MSA 프로젝트 배포하기
[참고] 완성 프로젝트 Github 주소
← 블로그 목록으로 돌아가기

API Gateway란?

JSCODE 박재성
JSCODE 박재성
2026. 03. 18.
author
JSCODE 박재성
category
MSA
createdAt
Dec 6, 2025 05:16 AM
isPublic
isPublic
series
비전공자도 이해할 수 있는 MSA 입문/실전
slug
what-is-api-gateway
type
post
updatedAt
Mar 18, 2026 09:00

✅ API Gateway란?

우선 Gateway라는 의미를 먼저 알아보자.
Gateway는 네트워크 상에서 다른 네트워크로 들어가는 입구 역할을 하는 지점을 의미한다.
 
그럼 API Gateway의 뜻은 뭘까?
API Gateway는 클라이언트(웹, 모바일 등)가 백엔드 API 서버에 접근하기 전에 거쳐가는 입구 역할을 하는 서버를 의미한다.
이 API Gateway의 의미는 그림으로 보면 조금 더 이해가 쉽다.
 
[API Gateway가 없을 때 통신하는 방식]
notion image
 
[API Gateway 있을 때 통신하는 방식]
notion image
 
 
 

✅ API Gateway를 사용하는 이유

API Gateway를 사용하는 이유를 찾아보면 여러가지가 있지만, 그 중에서 대표적인 이유는 크게 2가지이다.
  1. 라우팅 (Routing) : 클라이언트 요청을 적절한 서비스로 전달하기 위해 사용
    1. 지금까지 구성한 프로젝트를 보면 클라이언트가 각 서비스에 통신을 하려면, 각 서비스의 서로 다른 주소를 전부 알고 있어야 한다.
      • localhost:8080 (사용자 서비스)
      • locahlost:8081 (게시글 서비스)
      • localhost:8082 (포인트 서비스)
      하지만 API Gateway를 사용하면 클라이언트가 각 서비스에 통신을 해야 할 때, API Gateway 주소 하나로만 통신하면 된다.
      • localhost:8000 (사용자 서비스)
      • localhost:8000 (게시글 서비스)
      • localhost:8000 (포인트 서비스)
       
  1. 공통 로직 처리 : 인증, 로깅과 같이 여러 서비스에서 공통으로 사용하는 횡단 관심사 로직을 한 곳에서 처리
    1. 예를 들어, 각 서비스에 클라이언트 요청을 검증하기 위한 JWT 인증 로직이 각각 중복되어 있다고 해보자. 이 경우, 인증 로직을 일부 수정해야 한다면 모든 서비스 코드를 일일이 변경해야 하는 불편이 발생한다.
      notion image
       
      그래서 API Gateway를 활용하면, 아래 그림과 같이 각 서비스에 중복된 코드를 넣을 필요 없이 공통 로직을 API Gateway에서 일괄적으로 처리하도록 구성할 수 있다.
      notion image
 
 

✅ API Gateway를 구현할 때 많이 사용하는 툴

API Gateway를 구현할 때 활용할 수 있는 툴은 굉장히 많다. 현업에서는 대표적으로 크게 2가지를 많이 사용한다.
  • Spring Cloud Gateway : 프레임워크를 기반으로 직접 구현해야 하는 API Gateway 서버
  • AWS API Gateway : AWS에서 자체적으로 제공하는 API Gateway 서버
이 강의에서는 Spring Cloud Gateway를 활용해서 API Gateway를 구현해볼 예정이다.
📎
이 글은 비전공자도 이해할 수 있는 MSA 입문/실전 (feat. Spring Boot) 강의의 수업 자료 중 일부입니다.