powerplanning/webspa

Linux微服务单页应用Docker镜像

镜像概述和主要用途

本Docker镜像专为Linux系统设计，整合前端单页应用（SPA）与后端微服务组件，基于微服务架构提供一站式部署解决方案。通过容器化技术简化应用部署流程，实现前端与微服务的无缝集成，适用于需要快速交付、易于扩展的Web应用场景。

核心功能和特性

• 微服务架构支持：原生支持后端微服务组件集成，可灵活对接多个微服务实例
• 轻量级设计：优化镜像体积，基于Alpine Linux等轻量基础镜像，减少资源占用
• Linux系统优化：针对Linux内核特性优化，提升运行性能和稳定性
• 前后端分离集成：内置前端SPA静态资源服务与后端API网关，实现前后端分离架构的统一部署
• 快速部署：简化配置流程，支持一键启动，缩短从开发到生产的部署周期
• 可扩展性：支持水平扩展，可通过容器编排工具（如Kubernetes）实现服务弹性伸缩

使用场景和适用范围

• 企业级Web应用开发：适用于采用微服务架构的企业Web应用，简化多服务协同部署
• 微服务架构项目部署：作为微服务架构中前端与核心微服务的集成部署载体
• 开发与测试环境：提供一致的开发、测试和生产环境，减少环境差异导致的问题
• 需要快速扩展的Web服务：支持动态扩缩容，满足流量波动大的Web服务需求
• 前端与微服务集成验证：用于验证前端SPA与后端微服务接口的集成正确性

详细使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+）或Docker Desktop
• Linux系统环境（推荐Ubuntu 20.04+、CentOS 8+等）
• 网络环境支持访问Docker Hub或私有镜像仓库

拉取镜像

bash
docker pull [镜像仓库地址]/microservice-spa-linux:latest

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

基本运行命令

bash
docker run -d -p 8080:8080 --name microservice-spa \
  -e PORT=8080 \
  -e SERVICE_URL=http://backend-service:3000 \
  -e LOG_LEVEL=info \
  [镜像仓库地址]/microservice-spa-linux:latest

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3.8'
services:
  microservice-spa:
    image: [镜像仓库地址]/microservice-spa-linux:latest
    container_name: microservice-spa
    ports:
      - "8080:8080"
    environment:
      - PORT=8080
      - SERVICE_URL=http://backend-service:3000
      - LOG_LEVEL=info
      - CORS_ALLOWED_ORIGINS=https://example.com,https://api.example.com
    volumes:
      - ./config:/app/config  # 挂载自定义配置文件
      - ./logs:/app/logs      # 挂载日志目录
    depends_on:
      - backend-service  # 依赖的后端微服务
    restart: unless-stopped

  backend-service:
    image: [后端微服务镜像地址]
    container_name: backend-service
    ports:
      - "3000:3000"

环境变量配置

持久化与数据卷

• 配置文件挂载：将自定义配置文件目录挂载至/app/config，覆盖默认配置
• 日志目录挂载：将日志目录挂载至/app/logs，持久化存储应用日志
• 数据缓存挂载：如需持久化缓存数据，可挂载/app/cache目录

扩展与自定义

如需扩展或自定义应用，可通过以下方式：

1. 基于本镜像创建Dockerfile，添加自定义依赖或配置
2. 通过环境变量调整运行参数
3. 挂载外部配置文件覆盖默认设置
4. 结合Kubernetes等容器编排工具实现自动扩缩容