Versionamento, implantação e orquestração

O principal valor do Module Federation é a implantação independente: uma equipe pode atualizar, testar e implantar sua aplicação remota sem coordenar com as equipes das aplicações hospedeiras nem acionar novas implantações delas. A aplicação hospedeira incorpora as alterações automaticamente na próxima vez que carregar o remoteEntry.js da URL da aplicação remota.

Em vez de disponibilizar o remoteEntry.js em uma URL fixa, que muda a cada implantação, inclua um resumo do conteúdo na URL: remoteEntry.[hash].js. Isso torna cada implantação imutável — as URLs antigas continuam funcionando, e a aplicação hospedeira referencia o novo resumo assim que é atualizada para a nova implantação. URLs imutáveis permitem um armazenamento agressivo em cache na CDN.

Como a aplicação hospedeira descobre as aplicações remotas por meio da URL, você pode implementar testes A/B no nível da infraestrutura: disponibilize URLs diferentes de remoteEntry.js para usuários diferentes, apontando para versões remotas distintas. Isso permite implantações canário verdadeiras para microfrontends, sem qualquer lógica de sinalizador de funcionalidade no código da aplicação.

Em vez de codificar as URLs das aplicações remotas na configuração do Webpack, a aplicação hospedeira busca um manifesto JSON na inicialização: GET /federation-manifest.json retorna { buttonApp: 'https://cdn.example.com/button/remoteEntry.abc123.js' }. Para atualizar qual versão a aplicação hospedeira utiliza, atualize o manifesto — não é necessário recompilar a aplicação hospedeira.

Quando uma implantação remota introduz uma regressão, a reversão é imediata: atualize o federation-manifest.json para apontar para a URL anterior do remoteEntry.js. A aplicação hospedeira começará imediatamente a utilizar a versão antiga no próximo ciclo de requisição. Não é necessário recompilar nem reverter a aplicação hospedeira, nem coordenar as equipes.

A Federação de Módulos 2.0 (o pacote @module-federation/enhanced) traz melhorias significativas: melhor suporte a TypeScript, com geração automática de tipos a partir de manifestos remotos; uma API de plug-ins em tempo de execução para lógica de carregamento personalizada; e gerenciamento aprimorado de escopos compartilhados para cenários complexos de negociação de versões.

O pacote vite-plugin-federation leva a Federação de Módulos a projetos baseados em Vite, usando uma API de configuração semelhante à do ModuleFederationPlugin do Webpack. Ele é compatível tanto com remotos Vite e aplicações hospedeiras Webpack quanto no sentido inverso, permitindo que as equipes migrem gradualmente para Vite sem abandonar a Federação de Módulos.

Para arquiteturas altamente dinâmicas, você pode configurar as URLs dos remotos inteiramente em tempo de execução: import(remoteRegistry[featureName]), em que remoteRegistry é preenchido por uma chamada de API. Isso permite arquiteturas semelhantes a plug-ins, nas quais novos microfrontends podem ser adicionados sem recompilar a aplicação contêiner.

A principal função da aplicação contêiner é a orquestração: ela lê o manifesto remoto, inicializa o ambiente de execução da Federação de Módulos, registra os módulos remotos em rotas nomeadas e renderiza o remoto apropriado com base na URL atual. A aplicação contêiner é intencionalmente enxuta — ela sabe o que carregar, não como renderizá-lo.

Adicione monitoramento de desempenho ao carregamento dos remotos: envolva as importações dos remotos em try/catch para lidar adequadamente com falhas de carregamento (renderize uma interface de reserva se o remoto não estiver disponível), meça o tempo para baixar remoteEntry.js e os blocos dos componentes e emita um alerta se o tempo de carregamento do remoto exceder um limite (indicando problemas no CDN).

Um fluxo maduro de CI/CD para a Federação de Módulos segue esta sequência: a equipe remota envia uma alteração → a integração contínua compila o remoto → envia remoteEntry.[hash].js imutável para o CDN → atualiza federation-manifest.json → a aplicação hospedeira obtém o novo remoto na próxima solicitação do usuário. Cada etapa é automatizada, e a equipe da aplicação hospedeira nunca participa das implantações dos remotos.

A Federação de Módulos permite uma implantação realmente independente: os remotos são implantados sem recompilar a aplicação hospedeira, que descobre automaticamente as novas versões. Use URLs remotas com hash de conteúdo para obter cache imutável no CDN e um manifesto dinâmico para roteamento flexível de versões e reversões instantâneas. O vite-plugin-federation leva esses recursos ao Vite, e as importações dinâmicas de remotos permitem arquiteturas semelhantes a plug-ins. A aplicação contêiner orquestra o carregamento dos remotos, mantendo-se intencionalmente enxuta.