garystafford/spring-music-docker-tomcat

Spring Music Docker镜像（Tomcat版本）

镜像概述

本镜像为Spring Music应用的Docker化部署方案，基于Java Spring框架和MongoDB数据库，整合了Apache Tomcat、NGINX负载均衡、ELK日志栈（Elasticsearch、Logstash、Kibana）及Filebeat日志收集工具，支持多容器架构的构建、测试与监控。

核心功能

1. 多容器架构：包含NGINX代理、Tomcat应用实例（可扩展）、MongoDB数据库、ELK日志系统四大组件；
2. 负载均衡：NGINX实现Tomcat实例的轮询负载均衡，提升应用并发能力；
3. 静态资源优化：NGINX缓存静态资源，减少Tomcat压力并提高响应速度；
4. 日志聚合：通过Filebeat收集容器日志，ELK栈实现日志分析与可视化；
5. CI/CD支持：集成Travis CI自动化构建与部署流程，支持GitHub artifact管理。

使用场景

1. 本地开发测试：快速搭建Spring + MongoDB应用环境；
2. 学习实践：掌握Docker多容器部署、负载均衡及日志聚合技术；
3. 演示案例：展示企业级Java应用的容器化解决方案。

配置说明

依赖工具

需安装VirtualBox、Docker、Docker Compose、Docker Machine。

部署步骤

1. 克隆项目代码：

   bash
   git clone -b docker_v2 --single-branch https://github.com/garystafford/spring-music-docker.git music && cd music
   

2. 构建VirtualBox VM：

   bash
   docker-machine create --driver virtualbox springmusic
   eval "$(docker-machine env springmusic)"
   

3. 创建卷和网络：

   bash
   docker volume create --name music_data && docker volume create --name music_elk
   docker network create -d bridge music_net
   

4. 启动容器：

   bash
   docker-compose -p music up -d elk && sleep 15
   docker-compose -p music up -d mongodb && sleep 15
   docker-compose -p music up -d app && docker-compose scale app=3 && sleep 15
   docker-compose -p music up -d proxy && sleep 15
   

Docker Compose配置

核心配置文件docker-compose.yml采用v2格式，定义了proxy（NGINX）、app（Tomcat）、mongodb、elk四个服务，使用外部卷存储数据，通过bridge网络实现容器通信。

yaml
version: '2'
services:
  proxy:
    build: nginx/
    ports: [80:80]
    networks: [net]
    depends_on: [app]
  app:
    build: tomcat/
    ports: [8080]
    networks: [net]
    depends_on: [mongodb]
  mongodb:
    build: mongodb/
    ports: [27017:27017]
    networks: [net]
    depends_on: [elk]
    volumes: [music_data:/data/db, music_data:/data/configdb]
  elk:
    image: sebp/elk:latest
    ports: [5601:5601, 9200:9200, 5044:5044,5000:5000]
    networks: [net]
    volumes: [music_elk:/var/lib/elasticsearch]
volumes:
  music_data: {external: true}
  music_elk: {external: true}
networks:
  net: {driver: bridge}

测试验证

执行curl命令测试负载均衡效果：

bash
for i in {1..6}; do curl -I $(docker-machine ip springmusic); done

通过Upstream-Address字段可观察到请求轮询分配到不同Tomcat实例，且静态资源缓存后响应时间显著缩短。

===FULL_DESC===
# Spring Music Docker镜像（Tomcat版本）

## 镜像概述
本镜像为Spring Music应用的Docker化部署方案，基于Java Spring框架和MongoDB数据库，整合Apache Tomcat运行环境、NGINX负载均衡、ELK日志栈（Elasticsearch、Logstash、Kibana）及Filebeat日志收集工具，支持多容器架构的构建、测试、部署与监控。

## 核心功能
1. **多容器协同**：包含NGINX代理、可扩展Tomcat实例、MongoDB数据库、ELK日志系统四大组件；
2. **负载均衡**：NGINX实现Tomcat实例的轮询负载均衡，提升应用并发处理能力；
3. **静态资源优化**：NGINX缓存静态资源，减少Tomcat服务压力并提高前端响应速度；
4. **日志聚合分析**：Filebeat收集容器日志，ELK栈实现日志存储、检索与可视化；
5. **CI/CD集成**：支持Travis CI自动化构建与部署，通过GitHub管理构建产物。

## 使用场景
1. **本地开发测试**：快速搭建Spring + MongoDB应用环境，验证功能逻辑；
2. **技术学习实践**：掌握Docker多容器部署、负载均衡、日志聚合等企业级容器技术；
3. **演示案例**：展示Java应用容器化的完整解决方案，适用于培训或技术分享。

## 配置说明
### 依赖工具
需提前安装：VirtualBox、Docker、Docker Compose、Docker Machine。

### 部署步骤
1. **克隆项目代码**：
   ```bash
   git clone -b docker_v2 --single-branch https://github.com/garystafford/spring-music-docker.git music && cd music

2. 创建VirtualBox虚拟机：

   bash
   docker-machine create --driver virtualbox springmusic
   eval "$(docker-machine env springmusic)"
   

3. 初始化卷与网络：

   bash
   docker volume create --name music_data && docker volume create --name music_elk
   docker network create -d bridge music_net
   

4. 启动容器集群：

   bash
   # 按顺序启动服务（确保依赖服务就绪）
   docker-compose -p music up -d elk && sleep 15
   docker-compose -p music up -d mongodb && sleep 15
   docker-compose -p music up -d app && docker-compose scale app=3 && sleep 15
   docker-compose -p music up -d proxy && sleep 15
   

Docker Compose配置

核心配置文件docker-compose.yml采用v2格式，定义四大服务及资源依赖：

yaml
version: '2'
services:
  proxy: # NGINX代理服务
    build: nginx/
    ports: [80:80]
    networks: [net]
    depends_on: [app]
  app: # Tomcat应用服务（可扩展）
    build: tomcat/
    ports: [8080]
    networks: [net]
    depends_on: [mongodb]
  mongodb: # 数据库服务
    build: mongodb/
    ports: [27017:27017]
    networks: [net]
    depends_on: [elk]
    volumes: [music_data:/data/db, music_data:/data/configdb]
  elk: # 日志分析服务
    image: sebp/elk:latest
    ports: [5601:5601,9200:9200,5044:5044,5000:5000]
    networks: [net]
    volumes: [music_elk:/var/lib/elasticsearch]
volumes:
  music_data: {external: true} # 存储MongoDB数据
  music_elk: {external: true} # 存储ELK数据
networks:
  net: {driver: bridge} # 容器通信网络

验证方法

执行curl命令测试负载均衡效果：

bash
for i in {1..6}; do curl -I $(docker-machine ip springmusic); done

通过Upstream-Address字段可观察请求轮询分配到不同Tomcat实例，静态资源缓存后Request-Time显著缩短，验证负载均衡与缓存功能正常。