microlc/micro-lc

镜像概述

该镜像是一个开源的微前端编排工具，专为构建灵活、可扩展的多租户前端应用设计。它提供了微前端架构下的应用集成与管理能力，允许开发者将大型前端应用拆分为独立的微应用，并实现多租户环境下的定制化配置，从而提升前端系统的灵活性、可维护性和迭代效率。

核心功能与特性

微前端应用编排

支持多个独立开发的微前端应用的注册、加载与协同，实现微应用间的无缝集成与通信。

多租户支持

提供租户级别的配置隔离与定制能力，可针对不同租户需求定制微应用组合、样式及功能，满足多租户场景下的个性化需求。

灵活架构设计

采用松耦合架构，支持动态调整微应用组合与加载策略，适应业务需求变化，提升前端系统的扩展性。

开源可定制

基于开源协议分发，代码透明可审计，支持用户根据业务需求进行二次开发与功能扩展。

使用场景与适用范围

多团队协作开发

适用于多团队并行开发前端应用的场景，各团队可独立开发、测试和部署微应用，通过编排器实现集成，减少团队协作冲突。

多租户SaaS应用

面向需要支持多租户的SaaS平台，可通过该编排器为不同租户提供定制化的前端体验，如定制品牌、功能模块等。

大型前端应用拆分

用于将单体前端应用拆分为微前端架构，降低应用复杂度，提升开发效率和系统稳定性。

动态功能扩展

需要根据业务场景动态启用/禁用前端功能模块的应用，如电商平台的促销活动模块、企业应用的权限控制模块等。

使用方法与配置说明

基本部署

通过docker run命令快速启动容器：

bash
docker run -d -p 8080:8080 --name micro-frontend-orchestrator \
  -v /path/to/local/config:/app/config \
  your-image-name:latest

参数说明：

• -p 8080:8080：将容器内服务端口（默认8080）映射到主机端口
• -v /path/to/local/config:/app/config：挂载本地配置目录到容器，用于自定义租户配置、微应用列表等
• --name：指定容器名称，便于管理

环境变量配置

可通过环境变量调整服务运行参数，常用环境变量如下：

示例：指定日志级别为debug并修改服务端口：

bash
docker run -d -p 3000:3000 --name micro-frontend-orchestrator \
  -e PORT=3000 \
  -e LOG_LEVEL=debug \
  -v /path/to/local/config:/app/config \
  your-image-name:latest

配置文件说明

通过挂载的配置目录（/app/config）中的配置文件定义微应用与租户信息，核心配置文件为config.yaml，示例如下：

yaml
# 微应用列表配置
microApps:
  - name: "auth-app"        # 微应用名称（唯一标识）
    entry: "https://auth.example.com/entry.js"  # 微应用入口地址
    activeRule: "/auth"     # 路由匹配规则，命中时加载该微应用

  - name: "dashboard-app"
    entry: "https://dashboard.example.com/entry.js"
    activeRule: "/dashboard"

# 租户配置（多租户场景）
tenants:
  - tenantId: "tenant-a"    # 租户ID（唯一标识）
    microApps: ["auth-app", "dashboard-app"]  # 该租户可访问的微应用列表
    theme: "blue"           # 租户自定义主题

  - tenantId: "tenant-b"
    microApps: ["auth-app"]
    theme: "green"

验证部署

服务启动后，可通过访问http://localhost:8080验证部署状态，默认提供健康检查接口/health：

bash
curl http://localhost:8080/health
# 预期响应：{"status":"UP","timestamp":"2023-10-01T00:00:00Z"}