백엔드 개발 일지

마이크로서비스 아키텍처(Microservices Architecture)는 현대의 소프트웨어 개발에서 점점 더 널리 사용되는 접근 방식입니다. 그러나 이 아키텍처를 구축하고 운영하기 위해서는 몇 가지 중요한 원칙을 이해하고 적용해야 합니다. 이번 글에서는 마이크로서비스 아키텍처 구축 시 꼭 알아야 할 5가지 원칙에 대해 다루겠습니다.

1. 서비스의 분리(Single Responsibility Principle)

마이크로서비스 아키텍처에서 각 서비스는 특정한 비즈니스 기능을 수행해야 하며, 하나의 서비스가 여러 기능을 갖는 것은 지양해야 합니다. 이를 통해 각 서비스는 독립적으로 개발, 배포, 운영될 수 있습니다.

예를 들어, 사용자 인증과 상품 관리를 동일한 서비스에서 처리하는 것보다, 각각의 서비스를 분리하여 AuthService와 ProductService로 나누는 것이 좋습니다. 다음은 각 서비스를 Node.js로 구현하는 간단한 예입니다.

// AuthService.js
const express = require('express');
const app = express();
app.use(express.json());

app.post('/login', (req, res) => {
    // 로그인 로직
    res.send('로그인 성공');
});

app.listen(3000, () => {
    console.log('AuthService가 3000번 포트에서 실행 중입니다.');
});

// ProductService.js
const express = require('express');
const app = express();
app.use(express.json());

app.get('/products', (req, res) => {
    // 상품 조회 로직
    res.send('상품 목록');
});

app.listen(3001, () => {
    console.log('ProductService가 3001번 포트에서 실행 중입니다.');
});

2. 독립적인 배포(Independent Deployment)

각 마이크로서비스는 독립적으로 배포될 수 있어야 합니다. 이를 통해 특정 서비스의 기능 변경이나 버그 수정이 전체 시스템에 영향을 미치지 않도록 할 수 있습니다. 이를 위해 CI/CD(Continuous Integration/Continuous Deployment) 파이프라인을 구축하는 것이 중요합니다.

예를 들어, GitHub Actions를 사용하여 특정 서비스만 자동으로 배포하는 설정을 구현할 수 있습니다.

name: Deploy AuthService

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v2
      
      - name: Build and Deploy
        run: |
          cd AuthService
          npm install
          npm run build
          npm run deploy # 배포 스크립트 호출

3. 데이터 관리(Data Management)

마이크로서비스 아키텍처에서는 각 서비스가 자신의 데이터베이스를 가져야 합니다. 이를 통해 서비스 간의 결합도를 낮추고, 데이터 관리의 유연성을 높일 수 있습니다. 이때 데이터 일관성을 유지하기 위해 이벤트 소싱(Event Sourcing)이나 CQRS(Command Query Responsibility Segregation) 패턴을 사용할 수 있습니다.

예를 들어, 사용자가 상품을 구매할 때 OrderService가 ProductService에 주문 정보를 보내는 경우 다음과 같은 이벤트 기반 패턴을 사용할 수 있습니다.

// OrderService.js
const express = require('express');
const axios = require('axios');
const app = express();
app.use(express.json());

app.post('/order', async (req, res) => {
    const orderInfo = req.body;
    
    // 상품 서비스에 재고 감소 요청
    await axios.post('http://localhost:3001/decrease-stock', {
        productId: orderInfo.productId,
        quantity: orderInfo.quantity
    });

    res.send('주문 완료');
});

app.listen(3002, () => {
    console.log('OrderService가 3002번 포트에서 실행 중입니다.');
});

4. 서비스 간 통신(Service-to-Service Communication)

마이크로서비스 간의 통신은 HTTP REST API, gRPC, 메시지 큐 등 다양한 방법으로 이루어질 수 있습니다. 서비스 간의 통신 방식에 대한 고려는 성능과 확장성에 큰 영향을 미칠 수 있습니다. REST API를 사용하는 경우, 각 서비스가 명확한 API 계약을 가져야 하며, 이를 문서화하는 것이 중요합니다.

Swagger와 같은 도구를 사용하여 API 문서를 자동 생성하고 관리할 수 있습니다.

openapi: 3.0.0
info:
  title: AuthService API
  version: 1.0.0
paths:
  /login:
    post:
      summary: 로그인
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                username:
                  type: string
                password:
                  type: string
      responses:
        '200':
          description: 성공

5. 모니터링 및 로깅(Monitoring and Logging)

마이크로서비스 아키텍처에서는 각 서비스의 상태와 성능을 모니터링하고, 로그를 관리하는 것이 중요합니다. 이를 통해 문제가 발생했을 때 빠르게 대응할 수 있습니다. Prometheus, Grafana, ELK 스택(Elasticsearch, Logstash, Kibana) 등을 활용해 모니터링 및 로깅 시스템을 구축할 수 있습니다.

예를 들어, winston 라이브러리를 사용하여 Node.js 애플리케이션의 로그를 관리할 수 있습니다.

const winston = require('winston');

const logger = winston.createLogger({
    level: 'info',
    format: winston.format.json(),
    transports: [
        new winston.transports.Console(),
        new winston.transports.File({ filename: 'error.log', level: 'error' }),
        new winston.transports.File({ filename: 'combined.log' })
    ]
});

// 사용 예
logger.info('서비스가 시작되었습니다.');
logger.error('에러 발생: 서비스가 중지되었습니다.');

마무리

마이크로서비스 아키텍처는 높은 유연성을 제공하지만, 그에 따르는 복잡성도 존재합니다. 각 원칙을 잘 이해하고 적용함으로써 효율적이고 안정적인 마이크로서비스 시스템을 구축할 수 있습니다. 이번 글에서 소개한 5가지 원칙을 바탕으로 여러분의 프로젝트에 성공적인 마이크로서비스 아키텍처를 적용해보시길 바랍니다.