<div id="readability-page-1" class="page"><div id="post-content" itemprop="articleBody">import 함수는 실행 환경에 따라 전달받은 인자를 해석하여 해당 자원을 불러온다. 예를 들어 Node.js 환경에서는 파일을, 브라우져 환경에서는 HTTP 요청을 통해 자원을 로드한다.
이 특성을 이용하면 애플리케이션 초기 로딩 속도를 개선할 수 있겠다. 초기에는 최소한의 코드만 로드하고, 필요할 때 나머지 코드를 지연 로딩할 수 있기 때문이다.
이 글에서는 동적으로 자바스크립트 코드를 불러오는 기술인 모듈 페더레이션(Module Federation) 의 동작 원리를 살펴보겠다.
<h2 id="메니페스트를-가져오기"><a href="#%EB%A9%94%EB%8B%88%ED%8E%98%EC%8A%A4%ED%8A%B8%EB%A5%BC-%EA%B0%80%EC%A0%B8%EC%98%A4%EA%B8%B0" aria-label="메니페스트를 가져오기 permalink"></a>메니페스트를 가져오기</h2>
모듈 페더레이션으로 구성한 어플리케이션을 호스트(Host) 라고 부른다. 집에 손님을 초대해 파티를 주최하는 사람을 호스트라고 부르는 것과 비슷하다. 호스트는 원격 모듈(Remote Module) 이라는 외부 코드를 가져와 어플리케이션을 구성한다.
이를 위해 원격 모듈의 메니페스트(Manifest) 파일을 HTTP 요청으로 가져온다.
<div data-language="js"><pre><code>getManifestJson(manifestUrl, moduleInfo, extraOptions)</code></pre></div>
예를 들어 localhost:3000 에서 구동하는 호스트 어플리케이션은 다음 요청을 통해 원격 모듈의 메니페스트 파일을 가져 온다.
<div data-language="text"><pre><code>GET http://localhost:3001/dist/manifest.json</code></pre></div>
메니페스트는 다음 두 가지 정보를 제공한다.
<ol>
<li>remoteEntry: 원격 모듈의 진입점(Entry Point)</li>
<li>exposes: 노출된 모듈의 정보</li>
</ol>
remoteEntry에 대해 더 알아보자.
<h2 id="원격-진입점-가져오기"><a href="#%EC%9B%90%EA%B2%A9-%EC%A7%84%EC%9E%85%EC%A0%90-%EA%B0%80%EC%A0%B8%EC%98%A4%EA%B8%B0" aria-label="원격 진입점 가져오기 permalink"></a>원격 진입점 가져오기</h2>
원격 메니페스트를 가져온 호스트는 remoteEntry 필드에 있는 이름의 청크를가져온다. 이 파일은 호스트가 원격 모듈과 상호작용하기 위한 진입점이다.
호스트가 getRemoteEntry 를 호출해 RemoteEntry 파일을 불러온다.
<div data-language="js"><pre><code>function preloadAssets() {
 getRemoteEntry() // "http://localhost:3001/dist/myRemote.js"
}</code></pre></div>
브라우져는 아래와 같은 HTTP 요청을 통해 이 파일을 다운로드 한다.
<div data-language="text"><pre><code>GET http://localhost:3001/dist/myRemote.js</code></pre></div>
<h2 id="원격-컨테이너-생성"><a href="#%EC%9B%90%EA%B2%A9-%EC%BB%A8%ED%85%8C%EC%9D%B4%EB%84%88-%EC%83%9D%EC%84%B1" aria-label="원격 컨테이너 생성 permalink"></a>원격 컨테이너 생성</h2>
원격 모듈이 제공한 진입점은 모듈 로더를 제공한다.
<div data-language="js"><pre><code>// 모듈 맵
var moduleMap = {
 "./math": () =&gt; {
 /* ... */
 },
 "./Button": () =&gt; {
 /* ... */
 },
}

// 모듈 로더
var get = module =&gt; {
 return moduleMap[module]()
}</code></pre></div>
호스트가 get 함수에 모듈 이름을 전달하면 이 코드는 moduleMap에서 해당 청크를 찾는다.
호스트에서 원격 모듈의 특정 모듈을 사용하면 브라우져는 HTTP 요청을 통해 이 청크를 다운로드할 것이다.
<div data-language="text"><pre><code>GET http://localhost:3001/dist/__federation_expose_math.js</code></pre></div>
공유 스코프를 초기화하는 역할도 한다고 하는데 충분히 이해하지는 못했다.
<h2 id="원격-모듈을-사용하기"><a href="#%EC%9B%90%EA%B2%A9-%EB%AA%A8%EB%93%88%EC%9D%84-%EC%82%AC%EC%9A%A9%ED%95%98%EA%B8%B0" aria-label="원격 모듈을 사용하기 permalink"></a>원격 모듈을 사용하기</h2>
원격 모듈을 사용해 보자.
호스트에서 노출된 math 모듈을 가져온다.
<div data-language="js"><pre><code>import("myRemote/math").then(mathModule =&gt; {
 const math = mathModule.default
 math.add(1, 2) // 3
})</code></pre></div>
import 함수에 원격지 이름과 사용할 모듈 경로를 전달해 실행한다. 브라우져는 HTTP 요청을 만들고 코드 덩어리로 이행되는 프라미스를 반환한다.
<div data-language="text"><pre><code>GET http://localhost:3001/dist/__federation_expose_math.js</code></pre></div>
이 값이 이행되면 모듈 코드를 실행할 수 있다. default 필드에 담겨진 모듈의 원격 모듈의 add() 함수를 호스트에서 실행할 수 있다.

--
리액트 컴포넌트도 불러올 수 있다.
<div data-language="js"><pre><code>const Button = React.lazy(() =&gt; import("myRemote/Button"))

function App() {
 const [theme, setTheme] = React.useState("light")

 function handleClick() {
 setTheme(theme === "light" ? "dark" : "light")
 }

 return (
 &lt;&gt;
 &lt;h1&gt;Host&lt;/h1&gt;
 &lt;React.Suspense fallback={"Loading..."}&gt;
 &lt;Button theme={theme} onClick={handleClick}&gt;
 Change theme
 &lt;/Button&gt;
 &lt;/React.Suspense&gt;
 &lt;/&gt;
 )
}</code></pre></div>
마찬가지로 import 함수에 원격지 이름과 사용할 모듈 경로를 전달해 실행하면 같은 순서로 HTTP 요청을 만든다.
<div data-language="text"><pre><code>GET http://localhost:3001/dist/__federation_expose_button.js</code></pre></div>
원격지가 제공한 코드를 React.lazy 함수가 LazyComponent 로 조합해 반환할 것이다.
이 컴포넌트를 React.Suspense 컴포넌트와 함께 사용했다. 프라미스가 이행되기 전까지는 fallback 값을 렌더한다. 프라미스가 이행되어 값을 반환하면 호스트가 원격 모듈의 컴포넌트를 수신한 것이다. React.Suspense는 Button 컴포넌트를 그릴 것이다.
<h2 id="reactlazy와-비교"><a href="#reactlazy%EC%99%80-%EB%B9%84%EA%B5%90" aria-label="reactlazy와 비교 permalink"></a>React.lazy와 비교</h2>
<a href="/2024/12/18/react-lazy">앞서 살펴본 리액트의 lazy</a> 함수와 비슷하다. 동적으로 자바스크립트 코드 청크를 불러와 실행중인 어플리케이션과 결합하기 때문이다.
하지만 구조와 쓰임이 다르다.
1. 별도 프로젝트에서 사용
lazy는 같은 프로젝트에서만 사용할 수 있다. lazy 함수를 사용할 때 주석으로 청크 이름을 정의한다.
<div data-language="js"><pre><code>const myModule = React.lazy(() =&gt;
 /* WebpackChunkName: myModule */ import("./myModule.js")
)</code></pre></div>
웹팩은 이 주석을 보고 myModule.js 를 청크를 분리하고 WebpackChunkName에 해당하는 값으로 파일 이름을 만든다.
한편 모듈 페데레이션은 별도 프로젝트에서 원격 모듈을 정의할 수 있다. 호스트와 원격 모듈은 각자의 번들러를 사용해 모듈 페데레이션 빌드도구를 이용해서 코드를 번들한다.
2. 단독으로 배포
이러한 구조적 차이로 모듈 페더레이션을 사용하면 호스트와 원격이 서로 단독으로 배포할 수 있다. 모듈 간의 인터페이스만 맞다면 각 프로젝트가 독립적으로 업데이트해 배포할 수 있다.
3. 컴포넌트를 포함한 자바스크립트
리액트 lazy는 오직 리액트 컴포넌트만만 동적으로 로드하는 기능을 제공한다. 하지만 모듈 페더레이션은 이에 국한되지 않고, 자바스크립트로 작성한 모듈이라면 어떤 것이든 동적으로 로드할 수 있다.
예를 들어 앞서 살펴본 math 모듈처럼 단순한 유틸리티 함수도 제공할 수 있다. 비지니스 로직, 데이터 모델 등 다양한 종류의 모듈을 동적으로 공유해 로드할 수 있을 것이다.
<h2 id="결론"><a href="#%EA%B2%B0%EB%A1%A0" aria-label="결론 permalink"></a>결론</h2>
모듈 페더레이션은 import 함수를 이용해 원격 모듈과 호스트 모듈간에 코드 공유 기법이다. 원격 모듈이 모듈 시작점과 각 기능을 청크로 제공해서 누구든이 필요할 때 다운로드해 실행중인 어플리케이션과 동적으로 결합하는 방식이다.
이러한 구조는 React.lazy() 함수와 달리 별도 프로젝트에서 개발할 수 있다. 개발 의존성을 격리할 수 있고 단독으로 배포할 수 있어 더 유연하다.
<h2 id="참고"><a href="#%EC%B0%B8%EA%B3%A0" aria-label="참고 permalink"></a>참고</h2>
<ul>
<li><a href="https://github.com/jeonghwan-kim/jeonghwan-kim.github.io-examples/tree/main/2025-01-02-module-federation">예제 코드</a></li>
<li><a href="https://github.com/module-federation/core">module-federation/core | Github</a></li>
<li><a href="https://fe-developers.kakaoent.com/2022/220623-webpack-module-federation/">Webpack Module Federation 도입 전에 알아야 할 것들 | 카카오 FE 기술블로그</a></li>
</ul></div></div>

김정환 블로그 RSS Feed

김정환

import 함수는 실행 환경에 따라 전달받은 인자를 해석하여 해당 자원을 불러온다. 예를 들어 Node.js 환경에서는 파일을, 브라우져 환경에서는 HTTP…

모듈 페더레이션 구조와 동작 원리

댓글