mzdotai/lumigator-frontend

Lumigator Frontend 镜像文档

概述

Lumigator Frontend 镜像为 Lumigator 应用提供前端用户界面，是 Lumigator 应用架构的核心组件之一。该镜像基于现代 Web 技术栈构建，包含预编译的前端资源，可直接部署为独立服务，与 Lumigator 后端服务协同工作，为用户提供直观的操作界面和数据展示能力。

核心功能与特性

• 响应式用户界面：适配桌面端、平板及移动端设备，提供一致的操作体验。
• 数据可视化：集成图表组件，支持实时数据展示、历史趋势分析及统计报表生成。
• 用户交互功能：包含系统配置、任务管理、告警查看等核心操作模块，支持用户权限控制。
• 后端集成：通过 RESTful API 与 Lumigator 后端服务通信，自动处理数据请求与响应。
• 轻量级部署：基于 Nginx 或 Node.js 运行时，资源占用低，启动速度快。

使用场景

• Lumigator 应用完整部署：作为前端服务与 Lumigator 后端服务配合，构建完整应用系统。
• 开发与测试环境：用于前端功能验证、兼容性测试及用户体验优化。
• 演示环境：快速部署可演示版本，展示 Lumigator 应用核心功能。

使用方法

基本部署（Docker Run）

通过以下命令启动 Lumigator 前端服务：

bash
docker run -d \
  --name lumigator-frontend \
  -p 80:80 \
  -e API_URL=http://lumigator-backend:8080/api \
  lumigator/frontend:latest

Docker Compose 配置

推荐与后端服务协同部署，示例 docker-compose.yml 配置：

yaml
version: '3'
services:
  frontend:
    image: lumigator/frontend:latest
    ports:
      - "80:80"
    environment:
      - API_URL=http://backend:8080/api
    depends_on:
      - backend
  backend:
    image: lumigator/backend:latest
    # 后端服务配置...

环境变量配置

持久化与数据卷

前端服务通常无需持久化数据，若需自定义静态资源（如品牌Logo），可通过数据卷挂载覆盖默认资源：

bash
docker run -d \
  --name lumigator-frontend \
  -p 80:80 \
  -v ./custom-assets:/usr/share/nginx/html/assets \
  lumigator/frontend:latest

健康检查

容器内置健康检查机制，通过访问 /health 端点验证服务状态：

bash
# 手动检查
curl http://localhost:80/health
# 预期响应：{"status":"ok","timestamp":"2024-01-01T00:00:00Z"}

注意事项

• 确保前端服务与后端服务网络互通，API_URL 需配置为后端服务可访问的地址。
• 生产环境建议使用 HTTPS，可通过反向代理（如 Nginx、Traefik）配置 SSL 证书。
• 版本更新时，建议先备份自定义配置（如有），避免数据丢失。