ddtraining/storefront-fixed

Storefront (fixed) 服务镜像文档

镜像概述

Storefront (fixed) 服务镜像是ecommerce-workshop项目的专用前端服务镜像，旨在提供稳定、可靠的电子商务前端界面。该镜像基于项目原始Storefront服务优化而来，包含对已知问题的修复，确保在开发、测试及生产环境中稳定运行。

核心功能与特性

• 电子商务前端界面：提供商品浏览、搜索、详情展示、购物车管理及订单提交等完整电商前端功能
• 稳定性增强：基于"fixed"版本，修复了原始版本中的已知bug和兼容性问题
• 响应式设计：支持桌面端、平板及移动端等多设备访问
• 静态资源优化：内置资源压缩与缓存策略，提升页面加载速度
• 配置灵活性：支持通过环境变量自定义后端API地址、日志级别等关键参数

使用场景与适用范围

• ecommerce-workshop项目部署：作为项目标准前端组件，适用于开发、测试及生产环境
• 电商演示环境：快速搭建可展示完整电商流程的前端服务
• 教学与学习：作为电子商务技术栈实践中的前端服务示例

使用方法与配置说明

基本运行命令

bash
docker run -d -p 80:80 --name storefront-fixed docker.xuanyuan.run/ecommerce-workshop/storefront-fixed:latest

关键环境变量

带环境变量的运行示例

bash
docker run -d \
  -p 8080:80 \
  --name storefront-fixed \
  -e API_URL="http://backend-api:3000" \
  -e LOG_LEVEL="debug" \
  -e THEME="dark" \
  docker.xuanyuan.run/ecommerce-workshop/storefront-fixed:latest

Docker Compose配置示例

yaml
version: '3'
services:
  storefront:
    image: docker.xuanyuan.run/ecommerce-workshop/storefront-fixed:latest
    ports:
      - "80:80"
    environment:
      - API_URL=http://api:3000
      - LOG_LEVEL=info
    depends_on:
      - api
    restart: unless-stopped

数据持久化（可选）

如需自定义前端配置文件，可通过挂载卷实现：

bash
docker run -d \
  -p 80:80 \
  --name storefront-fixed \
  -v ./custom-config:/app/config \
  docker.xuanyuan.run/ecommerce-workshop/storefront-fixed:latest

版本标签说明

• latest：最新稳定版本
• vX.Y.Z：特定版本（如v1.0.0），对应项目发布的稳定版本
• dev：开发测试版本，包含最新功能但稳定性未验证

注意事项

• 确保后端API服务（API_URL指定的地址）已正常运行
• 生产环境建议使用特定版本标签而非latest，确保部署一致性
• 如需修改端口映射，需同步调整前端应用中的相关配置（如必要）