[Daily morning study] Strangler Fig Pattern — 레거시 시스템 점진적 마이그레이션

#daily morning study

Image


Strangler Fig Pattern이란?

Strangler Fig(스트랭글러 피그)는 열대 지방에 자라는 식물로, 숙주 나무를 감싸며 서서히 대체해 나가는 성질을 가진다. 소프트웨어 엔지니어링에서 이 이름을 빌린 패턴은 기존 레거시 시스템을 한 번에 교체하지 않고, 새로운 시스템으로 점진적으로 대체해 나가는 마이그레이션 전략이다.

Martin Fowler가 2004년에 소개한 개념으로, 대형 모놀리식 시스템을 마이크로서비스나 현대적 아키텍처로 전환할 때 가장 많이 사용된다.


왜 필요한가?

레거시 시스템을 한 번에 완전히 교체하는 방식(Big Bang Rewrite)은 다음과 같은 위험을 수반한다.

  • 완성될 때까지 비즈니스 가치를 전혀 제공하지 못함
  • 수년이 걸릴 수도 있고, 중간에 요구사항이 바뀌면 처음부터 다시 시작해야 함
  • 레거시 시스템의 암묵적 비즈니스 로직을 완전히 파악하기 어려움
  • 출시 직후 대규모 버그와 장애를 유발할 가능성이 높음

Strangler Fig Pattern은 이런 위험 없이 운영 중인 시스템을 안전하게 교체할 수 있게 해준다.


동작 방식

핵심 아이디어는 새 시스템과 레거시 시스템이 동시에 운영되면서, 트래픽을 점차 새 시스템으로 이전하는 것이다.

3단계 흐름

1단계: 파사드(Facade) / 프록시 도입
   클라이언트 → [Facade/Proxy] → 레거시 시스템

2단계: 기능 단위로 새 시스템 구현 및 트래픽 이전
   클라이언트 → [Facade/Proxy] → 새 시스템 (일부 기능)
                              → 레거시 시스템 (나머지 기능)

3단계: 레거시 완전 제거
   클라이언트 → [Facade/Proxy] → 새 시스템 (전체 기능)

구현 패턴

1. HTTP 프록시 기반 라우팅

가장 일반적인 방법. API Gateway나 Nginx 같은 프록시가 URL 경로 또는 헤더 기반으로 라우팅을 결정한다.

# Nginx 라우팅 예시
location /api/users/ {
    proxy_pass http://new-service;   # 마이그레이션 완료된 경로
}

location /api/orders/ {
    proxy_pass http://legacy-service; # 아직 레거시
}
# AWS API Gateway 예시 (OpenAPI spec)
paths:
  /users:
    x-amazon-apigateway-integration:
      uri: http://new-users-service/users
  /orders:
    x-amazon-apigateway-integration:
      uri: http://legacy-monolith/orders

2. 이벤트 인터셉션 (Event Interception)

메시지 버스나 이벤트 스트림을 활용해 레거시 시스템의 이벤트를 가로채 새 시스템으로 전달한다.

레거시 시스템 → 이벤트 발행 → Kafka Topic
                                   ↓
                           새 시스템이 consume
                           (동일한 이벤트 처리)

3. 데이터 동기화 계층

두 시스템이 동시에 데이터를 처리해야 하는 경우, 데이터 동기화가 필요하다.

레거시 DB (write)
     ↓ CDC (Change Data Capture)
  Kafka / Debezium
     ↓
새 시스템 DB (eventual consistency)

단계별 적용 예시: 모놀리스 → MSA

모놀리스 기능 목록:
- 사용자 관리 (User)
- 상품 카탈로그 (Product)
- 주문 처리 (Order)
- 결제 (Payment)
- 배송 추적 (Shipping)
단계이전한 기능레거시새 시스템
1단계User 서비스 분리Order, Product, Payment, ShippingUser Service
2단계Product 서비스 분리Order, Payment, ShippingUser, Product
3단계Order 서비스 분리Payment, ShippingUser, Product, Order
4단계Payment, Shipping 분리—모든 서비스

각 단계마다 충분한 검증과 모니터링 기간을 가진 후 다음 단계로 이동한다.


Branch by Abstraction과의 차이

비슷한 패턴으로 Branch by Abstraction이 있다. 두 패턴의 차이는 다음과 같다.

구분Strangler FigBranch by Abstraction
적용 범위외부 시스템 간 마이그레이션단일 코드베이스 내 리팩토링
트래픽 전환프록시/게이트웨이를 통해추상화 레이어로 구현 교체
주요 사용처모놀리스 → MSA의존성 교체, 내부 모듈 개선

고려해야 할 사항

데이터 일관성 문제

두 시스템이 동시에 운영되는 동안 데이터 중복과 불일치가 발생할 수 있다. 해결 방법:

  • 레거시 DB를 단일 진실 소스(source of truth)로 유지하고 새 시스템은 읽기 전용으로 시작
  • 또는 CDC(Change Data Capture)로 양방향 동기화 구성

파사드 복잡성

Facade가 비대해지면 오히려 병목이 될 수 있다. 가능하면 얇게 유지하고, 비즈니스 로직을 파사드에 넣지 않는다.

테스트 전략

새 시스템이 레거시와 동일한 동작을 하는지 검증하기 위해 Shadow Mode 를 활용할 수 있다.

클라이언트 요청
    ↓
파사드/프록시
 ├── 레거시 시스템 (실제 응답)
 └── 새 시스템 (Shadow: 요청만 보내고 응답은 버림)
      ↓
  두 응답 비교 → 로그/알림

언제 사용하면 좋은가

  • 레거시 모놀리스를 마이크로서비스로 분리할 때
  • 기존 시스템을 중단하지 않고 운영 중에 교체해야 할 때
  • 팀이 커져서 도메인별로 독립 배포가 필요할 때
  • 기술 스택 전환이 필요하지만 리스크를 최소화해야 할 때

단, 소규모 시스템이나 짧은 생명주기를 가진 프로젝트에는 오버엔지니어링이 될 수 있다. 복잡한 파사드와 데이터 동기화 비용이 편익을 초과하면 단순 재작성이 나을 수도 있다.