MSA 서비스 디스커버리 및 API 게이트웨이 패턴 개념과 사용법

MSA 아키텍처에서의 서비스 디스커버리 및 API 게이트웨이 패턴

마이크로서비스 아키텍처(MSA)는 애플리케이션을 작고 독립적인 서비스들의 모음으로 구성하는 방식입니다. 이러한 환경에서는 각 서비스가 서로를 어떻게 찾고 통신하는지, 그리고 외부 요청을 어떻게 효율적으로 관리하는지가 중요한 과제가 됩니다. 서비스 디스커버리(Service Discovery)와 API 게이트웨이(API Gateway) 패턴은 이러한 문제들을 해결하는 핵심적인 방법론입니다.

1. 서비스 디스커버리 (Service Discovery)

개념 정의: 서비스 디스커버리는 동적으로 변경되는 서비스 인스턴스들의 위치(IP 주소 및 포트) 정보를 중앙에서 관리하고, 다른 서비스가 필요한 서비스를 찾을 수 있도록 지원하는 패턴입니다. MSA 환경에서는 서비스 인스턴스들이 확장, 축소, 실패 등으로 인해 그 수가 수시로 변동할 수 있습니다. 서비스 디스커버리는 이러한 변화를 자동으로 감지하고 최신 상태를 유지하여 서비스 간의 안정적인 통신을 가능하게 합니다.

언제, 왜 사용해야 하는가?:

• MSA 환경: 여러 개의 마이크로서비스가 동적으로 배포되고 관리될 때 필수적입니다.
• 동적 확장/축소: 서비스 인스턴스 수가 자주 변동될 때 수동으로 IP와 포트를 관리하는 것은 비효율적이고 오류 발생 가능성이 높습니다.
• 탄력성 및 고가용성: 특정 서비스 인스턴스가 실패하더라도, 서비스 디스커버리는 다른 정상 인스턴스를 찾아 연결함으로써 전체 시스템의 가용성을 높입니다.

사용법 단계:

1. 서비스 등록 (Service Registration): 각 서비스 인스턴스는 시작될 때 자신의 네트워크 정보(IP, 포트, 메타데이터 등)를 서비스 디스커버리 서버(레지스트리)에 등록합니다.
2. 서비스 조회 (Service Lookup): 다른 서비스가 특정 서비스를 호출하고자 할 때, 서비스 디스커버리 서버에 해당 서비스 이름을 쿼리하여 사용 가능한 인스턴스들의 목록을 얻습니다.
3. 헬스 체크 (Health Check): 서비스 디스커버리 서버는 등록된 서비스 인스턴스들의 상태를 주기적으로 확인(헬스 체크)합니다. 비정상적인 인스턴스는 조회 대상에서 제외하여 안정적인 통신을 보장합니다.

주요 구현체 (예시):

• Netflix Eureka
• HashiCorp Consul
• Kubernetes Service Discovery (DNS 또는 kube-proxy)

주의사항:

• 서비스 디스커버리 서버 자체의 가용성이 중요합니다. 단일 장애점(Single Point of Failure)이 되지 않도록 이중화 또는 클러스터링 구성을 고려해야 합니다.
• 서비스 등록 및 해제 시 발생할 수 있는 레이턴시를 고려해야 합니다.

2. API 게이트웨이 (API Gateway)

개념 정의: API 게이트웨이는 클라이언트(웹 브라우저, 모바일 앱 등)의 모든 요청을 단일 진입점(Single Entry Point)으로 받아, 내부 마이크로서비스들에게 요청을 라우팅하고 응답을 집계하는 서버입니다. 클라이언트는 내부 서비스들의 복잡한 구조를 알 필요 없이 API 게이트웨이와 통신합니다.

언제, 왜 사용해야 하는가?:

• 클라이언트 요청 통합: 여러 마이크로서비스로 분산된 기능을 클라이언트에게 단일 API로 제공합니다.
• 요청 라우팅: 클라이언트의 요청을 적절한 마이크로서비스 인스턴스로 전달합니다.
• 역할 분리: 인증, 로깅, 모니터링, SSL 종단, 속도 제한(Rate Limiting) 등 공통적인 인프라스트럭처 기능을 API 게이트웨이에서 처리하여 각 마이크로서비스는 비즈니스 로직에만 집중할 수 있게 합니다.
• 응답 집계: 여러 서비스의 응답을 조합하여 클라이언트에게 단일 응답으로 제공합니다.

사용법 단계:

1. 단일 진입점 구성: 모든 외부 트래픽이 API 게이트웨이를 통하도록 네트워크 설정을 합니다.
2. 라우팅 규칙 설정: 들어오는 요청의 경로, 헤더, 메소드 등에 따라 어떤 내부 서비스로 전달할지 규칙을 정의합니다.
3. 미들웨어 기능 구현: 인증, 로깅, 변환 등 필요한 부가 기능을 게이트웨이에 구현하거나 연동합니다.
4. 서비스 디스커버리와 연동: API 게이트웨이는 서비스 디스커버리 서버를 통해 내부 서비스들의 최신 위치 정보를 얻어 동적으로 요청을 라우팅합니다.

주요 구현체 (예시):

• Spring Cloud Gateway
• Netflix Zuul
• Kong Gateway
• Envoy Proxy

주의사항:

• API 게이트웨이가 또 다른 단일 장애점이 될 수 있으므로, 고가용성을 확보해야 합니다.
• 게이트웨이가 너무 많은 기능을 담당하게 되면 복잡해지고 병목 현상이 발생할 수 있습니다. 적절한 기능 분담이 중요합니다.

3. 함께 사용하기

서비스 디스커버리와 API 게이트웨이는 MSA 환경에서 상호 보완적으로 사용됩니다. API 게이트웨이는 클라이언트의 요청을 받아 서비스 디스커버리를 통해 실제 서비스 인스턴스의 위치를 알아내어 요청을 전달합니다. 이 두 패턴을 함께 사용함으로써 MSA는 확장성, 탄력성, 유지보수성을 크게 향상시킬 수 있습니다.

짧은 예시 (개념적 흐름):

1. 클라이언트가 GET /users/123 요청을 API 게이트웨이에 보냅니다.
2. API 게이트웨이는 요청을 분석하여 'User Service'에 대한 요청임을 파악합니다.
3. API 게이트웨이는 서비스 디스커버리 서버에 'User Service'의 현재 활성 인스턴스 목록을 조회합니다.
4. 서비스 디스커버리 서버는 user-service-instance-1:8080 정보를 API 게이트웨이에 반환합니다.
5. API 게이트웨이는 user-service-instance-1:8080으로 요청을 프록시(forward)합니다.
6. 'User Service'는 요청을 처리하고 응답을 API 게이트웨이로 보냅니다.
7. API 게이트웨이는 응답을 클라이언트에게 최종적으로 전달합니다.

이러한 패턴들을 잘 이해하고 적용하면 복잡한 MSA 환경에서도 효율적이고 안정적인 시스템을 구축할 수 있습니다.