📌 NestJS + Kubernetes & 마이크로서비스 배포: 실전 가이드- 마이크로서비스 아키텍처(MSA) 개념과 NestJS 적용

📌 NestJS + Kubernetes & 마이크로서비스 배포: 실전 가이드

1. 마이크로서비스 아키텍처(MSA) 개념과 NestJS 적용

---

🔹 마이크로서비스란?

마이크로서비스 아키텍처(Microservices Architecture, MSA)는 하나의 애플리케이션을 여러 개의 독립적인 서비스로 분리하여 운영하는 아키텍처 패턴입니다.
NestJS는 마이크로서비스 패턴을 기본적으로 지원하며, 마이크로서비스 간 통신, API Gateway, 메시지 큐(RabbitMQ, Kafka)와의 통합 등을 쉽게 구현할 수 있습니다.

---

🔹 Monolithic vs. Microservices 비교

아키텍처 특징 장점 단점

Monolithic (모놀리식)	하나의 애플리케이션으로 구성	배포와 개발이 간단	확장성 부족, 유지보수 어려움
Microservices (마이크로서비스)	독립적인 서비스로 구성	확장성 뛰어나고 유지보수 용이	서비스 간 통신 복잡

💡 마이크로서비스는 서비스별 독립적인 확장 및 배포가 가능하여, 대규모 트래픽을 처리하는 서비스에 유리합니다.

---

🔹 NestJS에서 마이크로서비스 패턴 적용

반응형

✅ NestJS에서 마이크로서비스를 지원하는 방식

1. NestJS의 Microservices Module 활용
2. gRPC 기반 통신 지원
3. Kafka, RabbitMQ와 같은 메시지 큐 연동 가능
4. API Gateway를 통한 엔드포인트 통합 관리

---

🔹 NestJS 마이크로서비스 기본 프로젝트 구조

nestjs-microservices/
├── apps/
│   ├── api-gateway/  # API Gateway
│   ├── user-service/  # 사용자 서비스
│   ├── order-service/ # 주문 서비스
├── libs/
│   ├── common/        # 공통 유틸리티 모듈
│   ├── database/      # 공통 데이터베이스 모듈

💡 각 서비스는 독립적으로 실행되며, API Gateway를 통해 엔드포인트를 통합할 수 있습니다.

---

🔹 NestJS 마이크로서비스 기본 구현 (TCP 통신 예제)

✅ 1) nestjs 프로젝트 생성

nest new nestjs-microservices
cd nestjs-microservices

---

✅ 2) 사용자 서비스 생성 (user-service)

nest g app user-service

📂 apps/user-service/main.ts

import { NestFactory } from '@nestjs/core';
import { MicroserviceOptions, Transport } from '@nestjs/microservices';
import { UserModule } from './user.module';

async function bootstrap() {
  const app = await NestFactory.createMicroservice<MicroserviceOptions>(
    UserModule,
    {
      transport: Transport.TCP,
      options: { host: '127.0.0.1', port: 3001 },
    },
  );
  await app.listen();
}

bootstrap();

---

✅ 3) API Gateway 생성 및 설정

nest g app api-gateway

📂 apps/api-gateway/main.ts

import { NestFactory } from '@nestjs/core';
import { ApiGatewayModule } from './api-gateway.module';

async function bootstrap() {
  const app = await NestFactory.create(ApiGatewayModule);
  await app.listen(3000);
}
bootstrap();

📂 apps/api-gateway/user.controller.ts

import { Controller, Get, Inject } from '@nestjs/common';
import { ClientProxy } from '@nestjs/microservices';

@Controller('users')
export class UserController {
  constructor(@Inject('USER_SERVICE') private readonly client: ClientProxy) {}

  @Get()
  async getUsers() {
    return this.client.send('get_users', {});
  }
}

📂 apps/user-service/user.controller.ts

import { Controller } from '@nestjs/common';
import { MessagePattern } from '@nestjs/microservices';

@Controller()
export class UserController {
  @MessagePattern('get_users')
  async getUsers() {
    return [{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }];
  }
}

---

🔹 실행 및 테스트

✅ 1) User Service 실행

npm run start:user-service

출력 예시:

Listening on TCP: 127.0.0.1:3001

✅ 2) API Gateway 실행

npm run start:api-gateway

✅ 3) API 요청 테스트

curl http://localhost:3000/users

응답:

[
  { "id": 1, "name": "Alice" },
  { "id": 2, "name": "Bob" }
]

💡 NestJS의 Microservices Module을 활용하여, TCP 기반의 간단한 마이크로서비스를 구축할 수 있습니다.

---

🔹 마이크로서비스 적용 시 고려할 점

✔ 서비스 간의 독립적인 배포 및 확장 가능
✔ 통신 방식 선택이 중요 (gRPC, Kafka, RabbitMQ 등)
✔ 서비스 간 데이터 동기화 및 이벤트 기반 설계 필요
✔ Kubernetes 배포 시 서비스 간 네트워크 설정 고려 필요

---

🔹 결론: NestJS에서 마이크로서비스 아키텍처 시작하기

✅ NestJS는 마이크로서비스를 쉽게 구축할 수 있는 프레임워크
✅ TCP 기반의 마이크로서비스를 설정하고, API Gateway를 통해 서비스 호출 가능
✅ Kafka, RabbitMQ, gRPC 등 다양한 통신 방식 적용 가능
✅ 다음 글에서는 NestJS 마이크로서비스를 Docker로 컨테이너화하여 배포하는 방법을 다룹니다! 🚀

---

🔍 다음 글 예고: NestJS 마이크로서비스 컨테이너화 및 Docker 배포