[Daily morning study] 마이크로 프론트엔드(Micro Frontend) 아키텍처
#daily morning study
마이크로 프론트엔드란?
마이크로서비스 아키텍처(MSA)가 백엔드에 적용된 것처럼, 마이크로 프론트엔드(Micro Frontend)는 프론트엔드 애플리케이션을 독립적으로 개발·배포 가능한 여러 작은 조각으로 나누는 아키텍처 패턴이다.
전통적인 모놀리식 프론트엔드는 규모가 커질수록 다음 문제가 생긴다:
- 팀이 늘어날수록 코드 충돌이 잦아짐
- 하나의 기능 배포가 전체 앱 재배포를 요구
- 기술 스택 업그레이드가 전체에 영향을 미침
- 테스트·빌드 시간이 선형 이상으로 증가
마이크로 프론트엔드는 이런 문제를 “팀별로 프론트엔드를 분리”해서 해결한다.
핵심 개념
수직 분할 (Vertical Slice)
마이크로 프론트엔드의 핵심은 기능 단위로 수직으로 자르는 것이다.
전통적 모놀리식 (레이어 기반):
UI 레이어 ─────────────────────
서비스 레이어 ──────────────────
데이터 레이어 ──────────────────
마이크로 프론트엔드 (기능 기반):
│ 주문 도메인 │ 결제 도메인 │ 사용자 도메인 │
│ UI │ UI │ UI │
│ 서비스 │ 서비스 │ 서비스 │
│ 데이터 │ 데이터 │ 데이터 │
각 팀이 UI부터 API까지 완전한 수직 슬라이스를 소유한다.
통합 방식
1. 빌드 타임 통합
npm 패키지처럼 각 마이크로 앱을 패키지로 배포하고 컨테이너 앱에서 의존성으로 가져온다.
{
"dependencies": {
"@company/order-app": "^1.2.0",
"@company/payment-app": "^0.8.1"
}
}
장점: 타입 안전성, 간단한 구현
단점: 독립 배포 불가능. 하나가 바뀌면 전체 재빌드
2. 런타임 통합 — iframe
가장 단순한 런타임 통합. 각 앱을 iframe으로 삽입한다.
<iframe src="https://order.company.com" />
<iframe src="https://payment.company.com" />
장점: 완전한 격리, 기술 스택 무관
단점: 성능 오버헤드, UX 제약(라우팅, 공유 상태 처리 어려움)
3. 런타임 통합 — JavaScript
컨테이너 앱이 각 마이크로 앱의 JS 번들을 런타임에 동적으로 로드한다.
// container/index.js
const loadApp = async (appName, containerId) => {
const script = document.createElement('script');
script.src = `https://cdn.company.com/${appName}/bundle.js`;
script.onload = () => {
window[appName].mount(document.getElementById(containerId));
};
document.head.appendChild(script);
};
loadApp('orderApp', 'order-container');
loadApp('paymentApp', 'payment-container');
각 앱은 전역 객체에 mount/unmount 함수를 노출한다.
// order-app/index.js
window.orderApp = {
mount(container) {
ReactDOM.render(<App />, container);
},
unmount(container) {
ReactDOM.unmountComponentAtNode(container);
}
};
4. 런타임 통합 — Module Federation
Webpack 5의 Module Federation은 현재 가장 널리 쓰이는 방식이다. 런타임에 다른 앱의 모듈을 직접 가져올 수 있다.
// webpack.config.js (order-app — 제공자)
new ModuleFederationPlugin({
name: 'orderApp',
filename: 'remoteEntry.js',
exposes: {
'./OrderList': './src/components/OrderList',
'./App': './src/App',
},
shared: { react: { singleton: true }, 'react-dom': { singleton: true } },
});
// webpack.config.js (container — 소비자)
new ModuleFederationPlugin({
name: 'container',
remotes: {
orderApp: 'orderApp@https://order.company.com/remoteEntry.js',
},
shared: { react: { singleton: true }, 'react-dom': { singleton: true } },
});
소비자에서 사용:
// container/src/App.js
const OrderList = React.lazy(() => import('orderApp/OrderList'));
function App() {
return (
<Suspense fallback={<div>Loading...</div>}>
<OrderList />
</Suspense>
);
}
singleton: true로 설정하면 React 같은 공유 의존성이 중복 로드되지 않는다.
팀 간 통신
마이크로 앱들은 최대한 독립적이어야 한다. 직접 함수 호출보다는 느슨한 결합 방식을 쓴다.
Custom Events (브라우저 내장)
// 주문 앱이 이벤트 발행
window.dispatchEvent(new CustomEvent('order:completed', {
detail: { orderId: '123', total: 50000 }
}));
// 결제 앱이 이벤트 구독
window.addEventListener('order:completed', (e) => {
initiatePayment(e.detail.orderId, e.detail.total);
});
공유 상태 스토어
Redux나 Zustand 스토어를 공유 패키지로 추출해서 사용한다.
// @company/shared-store (npm 패키지)
export const sharedStore = createStore({
user: null,
cart: [],
});
// 각 앱에서
import { sharedStore } from '@company/shared-store';
라우팅 전략
컨테이너 앱이 URL을 보고 어떤 마이크로 앱을 렌더링할지 결정한다.
// container/src/router.js
const routes = {
'/orders': () => loadApp('orderApp'),
'/payment': () => loadApp('paymentApp'),
'/profile': () => loadApp('profileApp'),
};
const handleRouteChange = () => {
const handler = routes[window.location.pathname];
if (handler) handler();
};
window.addEventListener('popstate', handleRouteChange);
각 마이크로 앱은 자신의 경로 prefix(/orders/...) 내부에서만 라우팅을 처리한다.
스타일 격리
여러 앱이 동일한 DOM에 렌더링되면 CSS가 충돌한다. 해결 방법:
| 방법 | 특징 |
|---|---|
| CSS Modules | 빌드 타임에 클래스명을 유니크하게 변환 |
| Shadow DOM | 완전한 스타일 격리, 외부 CSS 차단 |
| CSS-in-JS | 런타임에 유니크 클래스명 생성 |
| BEM 네이밍 | 컨벤션으로 충돌 방지 (.order-app__button) |
// Shadow DOM으로 격리
class OrderWidget extends HTMLElement {
connectedCallback() {
const shadow = this.attachShadow({ mode: 'open' });
shadow.innerHTML = `
<style>/* 이 스타일은 shadow root 안에만 적용 */</style>
<div id="order-root"></div>
`;
ReactDOM.render(<App />, shadow.querySelector('#order-root'));
}
}
customElements.define('order-widget', OrderWidget);
장단점 정리
| 항목 | 장점 | 단점 |
|---|---|---|
| 배포 | 팀별 독립 배포 가능 | 배포 조율 복잡성 |
| 기술 스택 | 팀별 자유로운 선택 | 의존성 중복 가능성 |
| 팀 자율성 | 도메인 소유권 명확 | 초기 설계 비용 증가 |
| 성능 | 필요한 앱만 로드 | 번들 중복, 네트워크 오버헤드 |
| 테스트 | 범위가 좁아 테스트 용이 | 통합 테스트 어려움 |
언제 쓸까?
마이크로 프론트엔드가 적합한 상황:
- 팀이 여럿이고 각 팀이 독립적으로 배포해야 할 때
- 도메인이 명확히 나뉘는 대규모 앱 (e-커머스, 대시보드 플랫폼)
- 레거시 앱을 점진적으로 마이그레이션할 때 (Strangler Fig 패턴)
적합하지 않은 상황:
- 소규모 팀 (1~2개 팀)
- 도메인 경계가 불분명한 앱
- 성능이 극도로 중요한 경우
정리
마이크로 프론트엔드의 핵심은 팀의 자율성과 독립 배포다. 기술적인 복잡성이 증가하는 만큼 팀 규모와 도메인 분리가 충분히 보장될 때 도입을 고려해야 한다. Module Federation이 현재 가장 현실적인 구현 방법이고, Custom Events나 공유 스토어로 팀 간 통신을 최소화하는 것이 유지보수 측면에서 중요하다.