steadybit/gateway

shopping-demo 镜像文档

镜像概述和主要用途

shopping-demo 是一个用于演示购物场景的轻量级微服务应用镜像。该镜像旨在通过简化的购物流程（如商品浏览、购物车管理、订单模拟等）展示微服务架构的基本概念和实现方式，适合开发者学习、教学演示及微服务基础原理验证。

核心功能和特性

• 基础购物流程：支持商品列表展示、购物车添加/删除、模拟下单等核心购物场景操作
• 微服务架构示例：包含服务拆分演示（如商品服务、购物车服务、订单服务等模块化设计）
• 轻量级技术栈：采用简化技术架构，降低部署复杂度，支持快速启动和演示
• 可视化交互：提供基础Web界面或API接口，便于直观观察服务间交互流程

使用场景和适用范围

适用场景

• 开发者学习微服务架构设计与服务通信
• 教学环境中演示微服务拆分与集成
• 小型购物流程原型验证
• 技术分享中的微服务概念展示

限制说明

• 仅用于演示和学习目的，不包含生产环境所需的安全加固、数据持久化及高可用设计
• 不建议用于实际业务系统或生产环境部署

使用方法和配置说明

前提条件

• 已安装Docker Engine（推荐版本20.10+）
• 网络环境可访问镜像仓库（如Docker Hub）

基本使用流程

1. 拉取镜像

bash
docker pull [镜像仓库地址]/shopping-demo:latest

注：请将[镜像仓库地址]替换为实际镜像存储地址（如Docker Hub用户名或私有仓库URL）

2. 启动容器

bash
docker run -d -p 8080:8080 --name shopping-demo-instance shopping-demo:latest

3. 访问服务

容器启动后，通过浏览器或API工具访问：

http://localhost:8080

高级配置

环境变量配置

支持通过环境变量调整服务参数，常用配置项如下：

自定义配置示例

bash
docker run -d \
  -p 9000:9000 \
  -e PORT=9000 \
  -e LOG_LEVEL=DEBUG \
  -e DEMO_DATA=false \
  --name shopping-demo-custom \
  shopping-demo:latest

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  shopping-demo:
    image: shopping-demo:latest
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - LOG_LEVEL=INFO
      - DEMO_DATA=true
    restart: unless-stopped

启动服务：

bash
docker-compose up -d

注意事项

• 演示数据默认存储在内存中，容器重启后数据将丢失
• 如需持久化数据，可通过挂载卷实现（示例命令）：

  bash
  docker run -d -p 8080:8080 -v ./demo-data:/app/data --name shopping-demo-persist shopping-demo:latest
  

• 高并发场景下可能出现性能瓶颈，建议仅用于低负载演示环境