namecheap/ilc_registry

Isomorphic Layout Composer (ILC) 镜像文档

1. 镜像概述与主要用途

Isomorphic Layout Composer (ILC) 是一个布局服务，核心功能是从多个片段服务（fragment services）组合生成完整的网页，同时支持客户端和服务器端两种页面组合模式。其主要用途是作为微前端架构中的布局引擎，实现模块化Web页面的动态组合与渲染。

2. 核心功能和特性

• 多片段服务整合：支持将多个独立部署的片段服务（如微前端应用、组件服务等）组合为统一网页
• 双端渲染支持：同时支持客户端（浏览器）和服务器端的页面组合，满足性能与SEO需求
• 灵活的布局配置：通过配置定义片段的位置、尺寸及依赖关系，实现动态页面结构调整
• 微前端架构兼容：原生支持微前端开发模式，便于多团队协作与独立迭代

3. 使用场景和适用范围

• 大型Web应用模块化开发：适用于需拆分为多个独立功能模块的Web应用
• 微前端架构实现：作为微前端架构的核心布局层，整合不同技术栈的前端片段
• 多团队协作开发：支持多团队并行开发独立模块，通过ILC统一整合前端输出
• 混合渲染需求场景：需同时支持服务器端渲染(SSR)和客户端渲染(CSR)的Web项目

4. 使用方法和配置说明

4.1 基本部署（Docker Run）

bash
docker run -d \
  --name ilc \
  -p 8080:8080 \
  -e NODE_ENV=production \
  -e ILC_REGISTRY_URL=http://registry.example.com \
  namecheap/ilc:latest

4.2 Docker Compose部署

yaml
version: '3.8'

services:
  ilc:
    image: namecheap/ilc:latest
    container_name: ilc
    ports:
      - "8080:8080"
    environment:
      - NODE_ENV=production
      - PORT=8080
      - ILC_REGISTRY_URL=http://ilc-registry:3000
      - LOG_LEVEL=info
      - CACHE_TTL=300
    depends_on:
      - ilc-registry

  ilc-registry:
    image: namecheap/ilc-registry:latest
    container_name: ilc-registry
    ports:
      - "3000:3000"

启动命令：docker-compose up -d

4.3 环境变量配置

4.4 配置文件挂载

如需自定义布局规则或路由映射，可挂载配置文件：

bash
docker run -d \
  --name ilc \
  -p 8080:8080 \
  -v $(pwd)/config/ilc.config.js:/app/config/ilc.config.js \
  -e NODE_ENV=production \
  namecheap/ilc:latest

配置文件示例(ilc.config.js)：

javascript
module.exports = {
  routes: [
    {
      path: '/home',
      layout: 'main',
      fragments: [
        { name: 'header', service: 'header-service', props: { theme: 'dark' } },
        { name: 'content', service: 'content-service', path: '/home-content' }
      ]
    }
  ],
  layouts: {
    main: {
      template: '<div class="header">{{header}}</div><div class="content">{{content}}</div>'
    }
  }
};

5. 参考链接

• 官方GitHub仓库: https://github.com/namecheap/ilc