마이크로 프론트엔드로 프론트엔드 개발 확장하기
인사이트로 돌아가기
제품 및 기술

마이크로 프론트엔드로 프론트엔드 개발 확장하기

2023-12-10
6분 읽기

핵심 요약

"프론트엔드 모놀리스를 쪼개 자율적인 팀이 독립적으로 배포할 수 있게 하는 방법입니다."

프론트엔드 모놀리스 문제

백엔드 팀은 오래전에 마이크로서비스를 정착시켰습니다. 모놀리스를 독립적으로 배포할 수 있는 서비스로 나누었고, 각 서비스는 작은 팀이 소유하며 자체 릴리스 주기를 가집니다. 그 결과 반복이 빨라지고, 소유권이 분명해지고, 배포 병목이 줄었습니다.

프론트엔드 팀은 대체로 같은 혜택을 받지 못했습니다. 정교한 백엔드 아키텍처를 갖춘 조직에서도 프론트엔드는 저장소 하나, 빌드 파이프라인 하나, 배포 산출물 하나로 남아 있는 경우가 많습니다. 대시보드 팀, 결제 팀, 관리자 팀 등 UI를 건드리는 모든 팀이 같은 코드베이스에 커밋하고, 같은 CI 파이프라인을 기다리고, 함께 배포합니다.

규모가 작을 때는 문제없습니다. 프론트엔드 개발자가 두세 명이면 조율할 만합니다. 그러나 같은 애플리케이션의 서로 다른 부분을 맡은 프론트엔드 팀이 다섯, 여덟, 열두 개가 되면 모놀리스가 병목이 됩니다. 결제 모듈의 테스트 하나가 깨지면 대시보드 팀의 배포가 막힙니다. 한 팀의 의존성 업그레이드가 다른 팀의 컴포넌트를 망가뜨립니다. 스프린트 계획은 독립적인 우선순위 결정이 아니라 공유 자원을 두고 벌이는 협상이 됩니다.

이것이 프론트엔드 모놀리스의 함정이고, 마이크로 프론트엔드는 여기서 벗어나는 방법 중 하나입니다.

프론트엔드 아키텍처 다이어그램

마이크로 프론트엔드란 무엇인가

개념은 단순합니다. 프론트엔드를 독립적으로 개발, 테스트, 배포할 수 있는 더 작은 조각으로 나누는 것입니다. 각 조각은 한 팀이 소유하며 상품 카탈로그, 사용자 프로필, 결제 흐름, 관리자 패널 같은 비즈니스 도메인에 대응합니다.

각 마이크로 프론트엔드는 자체 기술 스택, 자체 빌드 파이프라인, 자체 릴리스 일정을 가질 수 있습니다. "셸" 또는 "호스트"라고도 부르는 컨테이너 애플리케이션은 라우팅, 공통 내비게이션, 개별 마이크로 프론트엔드를 하나의 일관된 사용자 경험으로 조합하는 일을 맡습니다.

구현 방식은 여러 가지이며, 각각 트레이드오프가 다릅니다.

모듈 페더레이션(Webpack 5 / Rspack)

React 기반 애플리케이션에서 가장 널리 쓰이는 방식입니다. 각 마이크로 프론트엔드는 특정 컴포넌트를 노출하는 별도의 Webpack 빌드입니다. 호스트 애플리케이션은 이 컴포넌트를 서로 다른 URL에서 런타임에 불러옵니다. 팀은 독립적으로 배포하며, 결제 팀이 새 버전을 올리면 호스트 애플리케이션은 재배포 없이 자동으로 이를 가져옵니다.

장점은 성능입니다. 공유 의존성(React, 디자인 시스템)은 한 번만 로드되어 모든 마이크로 프론트엔드가 함께 씁니다. 개발 경험은 모놀리스에 가깝습니다. 핫 모듈 교체가 동작하고, TypeScript 타입을 공유할 수 있으며, 익숙한 멘탈 모델을 그대로 쓸 수 있습니다.

한계는 결합입니다. 모든 마이크로 프론트엔드가 React 버전과 주요 공유 의존성에 합의해야 합니다. React를 업그레이드하려면 모든 팀 사이의 조율이 필요하며, 이는 마이크로 프론트엔드가 없애려던 바로 그 조율입니다.

Single-SPA

Single-SPA는 다른 방식을 취합니다. 각 마이크로 프론트엔드는 완전히 독립된 애플리케이션이며, 프레임워크도 전혀 다르게 쓸 수 있습니다. 한 팀은 React, 다른 팀은 Vue, 또 다른 팀은 Angular를 쓸 수 있습니다. single-spa 오케스트레이터가 현재 라우트에 따라 애플리케이션을 마운트하고 언마운트합니다.

장점은 진정한 독립성입니다. 팀은 다른 누구와도 조율하지 않고 기술 결정을 내립니다. 프레임워크 업그레이드는 각 팀이 정할 일입니다.

대가는 성능입니다. 프레임워크가 늘 때마다 번들 크기가 커집니다. 세 개의 마이크로 프론트엔드가 서로 다른 세 가지 React 버전을 쓰면 사용자는 React를 세 번 내려받습니다. 번들 크기가 덜 중요한 사내 엔터프라이즈 애플리케이션에서는 이 트레이드오프를 받아들일 만할 수 있습니다. 소비자용 애플리케이션에서는 보통 그렇지 않습니다.

서버 사이드 조합

SEO와 초기 로딩 성능이 가장 중요한 애플리케이션에서는, 서버 사이드 조합이 HTML을 브라우저로 보내기 전에 엣지나 서버에서 마이크로 프론트엔드를 조립합니다. IKEA와 Zalando 같은 기업이 이커머스 플랫폼에 쓰는 방식입니다.

컴포넌트를 작업하는 개발 팀

마이크로 프론트엔드가 맞는 경우

마이크로 프론트엔드는 복잡성을 더합니다. 이것은 비판이 아니라 도입 결정의 기준이 되어야 할 사실입니다. 모놀리스가 주는 조직적 고통이 분해에 드는 기술적 비용보다 클 때만 추가되는 복잡성이 정당화됩니다.

저희가 수행한 프로젝트에서 얻은 경험칙은 다음과 같습니다.

  • 독립적인 프론트엔드 팀 3개 이상: 이보다 적으면 모놀리스 안에서의 조율을 감당할 만합니다. 이를 넘으면 배포 충돌과 머지 병목이 상당한 엔지니어링 시간을 잡아먹기 시작합니다.
  • 서로 다른 릴리스 주기: 마케팅 팀은 랜딩 페이지를 매일 수정해야 하는데 핵심 제품은 격주로 배포한다면, 같은 릴리스 주기에 묶어 두는 것은 불필요한 마찰을 만듭니다.
  • 인수한 제품: 인수 후에는 새로 인수한 애플리케이션을 기존 플랫폼에 통합해야 하는 경우가 많습니다. 마이크로 프론트엔드를 쓰면 인수한 UI를 다시 작성하지 않고 그대로 넣을 수 있습니다.
  • 점진적인 마이그레이션: 오래된 Angular 애플리케이션에서 React로 옮기고 있습니까? 마이크로 프론트엔드를 쓰면 나머지 애플리케이션은 그대로 돌리면서 한 번에 한 영역씩 다시 만들 수 있습니다.

소규모 팀, 초기 단계의 제품, 한 팀이 UI 전체를 소유하는 애플리케이션에는 마이크로 프론트엔드가 맞지 않습니다. 여러 빌드 파이프라인, 공유 의존성 버전, 마이크로 프론트엔드 간 통신을 관리하는 부담은 공짜가 아닙니다. 개발자가 네 명인 팀이라면 모듈 경계가 분명한 잘 구조화된 모놀리스가 거의 언제나 더 나은 선택입니다.

모듈형 아키텍처 시각화

접착제 역할을 하는 디자인 시스템

마이크로 프론트엔드의 가장 큰 위험은 시각적 파편화입니다. 팀마다 자기 버튼, 자기 폼 입력창, 자기 색상 팔레트를 만들면 사용자 경험은 서로 다른 제품 다섯 개를 이어 붙인 것 같은 일관성 없는 조각보로 떨어집니다.

해법은 모든 마이크로 프론트엔드가 가져다 쓰는 컴포넌트 라이브러리, 곧 공유 디자인 시스템입니다. 선택 사항이 아닙니다. 마이크로 프론트엔드 아키텍처에서 가장 중요한 단일 투자입니다.

디자인 시스템은 전담 팀(또는 순환하는 길드)이 소유하고 버전을 붙인 패키지로 배포해야 합니다. 마이크로 프론트엔드는 특정 버전에 고정하고 각자의 일정에 맞춰 업그레이드합니다. 이렇게 하면 결합 없이 일관성을 얻습니다. 팀은 독립 배포를 유지하면서 같은 버튼과 타이포그래피를 씁니다.

실무에서 저희는 디자인 시스템을 npm 패키지와 Storybook 문서로 함께 배포합니다. 모든 컴포넌트는 Chromatic으로 시각적으로 테스트하므로, 디자인 시스템의 변경이 이에 의존하는 마이크로 프론트엔드를 의도치 않게 깨뜨리지 않도록 합니다.

디자인 시스템 컴포넌트 라이브러리

성능과 실무상의 고려 사항

마이크로 프론트엔드 아키텍처의 성능에는 의식적인 관리가 필요합니다. 그렇지 않으면 JavaScript를 더 많이 내려보내고, 네트워크 요청을 더 많이 만들며, 교체한 모놀리스보다 느린 경험을 만들게 됩니다.

핵심 고려 사항은 다음과 같습니다.

  • 공유 의존성 중복 제거: Module Federation의 공유 스코프를 사용해 React와 디자인 시스템 같은 라이브러리가 마이크로 프론트엔드마다가 아니라 정확히 한 번만 로드되도록 합니다.
  • 지연 로딩: 사용자가 해당 라우트로 이동할 때만 마이크로 프론트엔드를 로드합니다. 사용자가 상품 카탈로그를 보고 있다면 결제 모듈은 초기 번들에 들어 있을 필요가 없습니다.
  • 프리페치: 사용자의 이동을 예측해 유휴 시간에 다음에 이동할 가능성이 높은 마이크로 프론트엔드를 미리 가져옵니다. 별도 번들을 불러올 때의 네트워크 지연이 드러나지 않게 됩니다.
  • 공유 상태 관리: 마이크로 프론트엔드 간 상태는 최소화해야 합니다. 공유 Redux 스토어 대신 이벤트나 가벼운 pub/sub 메커니즘을 사용하십시오. 각 마이크로 프론트엔드는 자기 상태를 소유하고 잘 정의된 계약으로 소통해야 합니다.

GTEMAS의 프론트엔드 역량

GTEMAS는 핀테크, 이커머스, 물류 분야의 엔터프라이즈 고객을 위해 마이크로 프론트엔드 아키텍처를 구축했습니다. 표준 접근 방식은 Storybook으로 배포하는 공유 디자인 시스템과 함께 Module Federation을 사용하는 것입니다. GitHub Actions로 마이크로 프론트엔드마다 독립적인 CI/CD 파이프라인을 구성하고, Chromatic으로 시각 회귀 테스트를 자동화합니다.

모든 프로젝트에 마이크로 프론트엔드를 권하지는 않습니다. 많은 고객에게는 Turborepo나 Nx를 쓴 잘 구조화된 모노레포가, 배포가 여러 개 늘어나는 운영 부담 없이 충분한 팀 독립성을 제공합니다. 맞는 아키텍처는 팀 규모, 릴리스 빈도, 해결하려는 구체적인 문제에 따라 달라집니다.

GTEMAS 프론트엔드 팀의 배포

프론트엔드 팀이 커지고 배포 조율이 병목이 되고 있다면 마이크로 프론트엔드에 대해 이야기해 볼 만합니다. 분해가 귀사의 상황에 맞는지 평가하고, 맞는다면 사용자 경험을 희생하지 않으면서 독립성을 확보하는 아키텍처를 설계하는 일을 도와드릴 수 있습니다.

저희 프론트엔드 아키텍처 팀과 이야기해 보세요.

엔지니어링 조언이 필요하신가요?

무엇을 만들고 계신지 GTEMAS 팀에 알려 주시고, 전문가와 함께 이야기해 보세요.

전문가와 상담하기