mitarbrankovic / nx-module-federation-docker

Implementation of NX Angular Dynamic Module Federation with Docker, webpack5. For backend it will be used Spring Boot and Kafka Message Broker.

NX Angular Module Federation with Docker

How to start app?

Without Docker, inside modulefederation folder run:

npm i

npx nx serve shell --devRemotes="first-microfront, second-microfront"

possible without devRemotes but it won't rerender when you change something on some microfront(not shell)

---

With Docker, inside docker folder run:

docker compose -f modulefederation-microfrontends.yml up -d

Other usefull commands:

docker compose -f modulefederation-microfrontends.yml down
docker compose -f modulefederation-microfrontends.yml build

Also you can build each microfrontend separatetly using other docker-composes inside docker folder.

Module Federation Setup

• Check official NX documentation
• In folder Documentation you can see how to setup project and how to install Angular Materials
• Install NX console for generating components, libraries, modules...

You can follow documentation for generating microfronts, modules, and components, or personally its easier to do all that by using NX console.

Host->(Remotes)->Modules->Components

1. Generating host using NX console - set name(shell), check dynamic checkbox and set style(css, scss...).

npx nx generate @nrwl/angular:host shell --dynamic --style=scss --no-interactive --dry-run

2. Generating remotes using NX console - set name, host(shell) and style.

npx nx generate @nrwl/angular:remote first-microfront --host=shell --style=scss --no-interactive --dry-run

3. Line for generating Module in which will be components in shell/microfront:

npx nx generate @schematics/angular:module newModule --project=shell --routing --no-interactive --dry-run

or do it using nx console(check routing checkbox).

4. Line for generating Component:

npx nx generate @nrwl/angular:component newComponentt --project=shell --no-interactive --dry-run 

After that add component inside declarations inside it's module.

For displaying component inside Microfront its necessary to set path to module inside entry.routes.ts, and add route to component inside component-routing.module.ts

For libraries its necessary to add new exports in "index.ts" for each new class you want to be accessable from outside of library(services, models).

Presentation about NX Module Federation

Dynamic Module Federation - how it works?

Example of displaying remote inside it's host.

Dockerization of Module Federation

• Make docker-compose.yml file
• Add Dockerfile to each microfrontend(host and remotes)
• Add nginx.conf file to each microfrontend

Possible errors:

TypeError: Failed to fetch dynamically imported module because of

Expected a JavaScript module script but the server responded with a MIME type of "text/plain". Strict MIME type checking is enforced for module scripts per HTML spec. or CORS.

How to fix it?

In nginx.conf you have to add MIME types and header for CORS:

For some reason include mime.types didn't work so i explicitly imported all types in nginx.conf and added mjs for JavaScript and that one line for CORS.

Stackoverflow

If you added some services/models inside lib/shared you will have to build and up libs also:

docker compose -f modulefederation-libs.yml up -d