[Daily morning study] Strangler Fig Pattern — 레거시 시스템 점진적 마이그레이션
#daily morning study
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, Shipping | User Service |
| 2단계 | Product 서비스 분리 | Order, Payment, Shipping | User, Product |
| 3단계 | Order 서비스 분리 | Payment, Shipping | User, Product, Order |
| 4단계 | Payment, Shipping 분리 | — | 모든 서비스 |
각 단계마다 충분한 검증과 모니터링 기간을 가진 후 다음 단계로 이동한다.
Branch by Abstraction과의 차이
비슷한 패턴으로 Branch by Abstraction이 있다. 두 패턴의 차이는 다음과 같다.
| 구분 | Strangler Fig | Branch by Abstraction |
|---|---|---|
| 적용 범위 | 외부 시스템 간 마이그레이션 | 단일 코드베이스 내 리팩토링 |
| 트래픽 전환 | 프록시/게이트웨이를 통해 | 추상화 레이어로 구현 교체 |
| 주요 사용처 | 모놀리스 → MSA | 의존성 교체, 내부 모듈 개선 |
고려해야 할 사항
데이터 일관성 문제
두 시스템이 동시에 운영되는 동안 데이터 중복과 불일치가 발생할 수 있다. 해결 방법:
- 레거시 DB를 단일 진실 소스(source of truth)로 유지하고 새 시스템은 읽기 전용으로 시작
- 또는 CDC(Change Data Capture)로 양방향 동기화 구성
파사드 복잡성
Facade가 비대해지면 오히려 병목이 될 수 있다. 가능하면 얇게 유지하고, 비즈니스 로직을 파사드에 넣지 않는다.
테스트 전략
새 시스템이 레거시와 동일한 동작을 하는지 검증하기 위해 Shadow Mode 를 활용할 수 있다.
클라이언트 요청
↓
파사드/프록시
├── 레거시 시스템 (실제 응답)
└── 새 시스템 (Shadow: 요청만 보내고 응답은 버림)
↓
두 응답 비교 → 로그/알림
언제 사용하면 좋은가
- 레거시 모놀리스를 마이크로서비스로 분리할 때
- 기존 시스템을 중단하지 않고 운영 중에 교체해야 할 때
- 팀이 커져서 도메인별로 독립 배포가 필요할 때
- 기술 스택 전환이 필요하지만 리스크를 최소화해야 할 때
단, 소규모 시스템이나 짧은 생명주기를 가진 프로젝트에는 오버엔지니어링이 될 수 있다. 복잡한 파사드와 데이터 동기화 비용이 편익을 초과하면 단순 재작성이 나을 수도 있다.