Spring Boot+Nginx+MySQL容器化实战指南_Java

一、实现目标

1.1 概述

编写一个spring-boot程序，返回user表的所有数据，并且通过nginx反向代理实现。

1.2 表定义

# 文件名：init.sql 
drop database if exists test;
create database `test` default character set utf8mb4;
use `test`;
create table `users` (
    `sno` int(11) default null,
    `sname` varchar(50) default null
) engine=innodb default charset=utf8mb4;
insert into users (sno, sname) values
    (1, 'hyy'),
    (2, 'blog');

小提示：
init.sql需要存放到容器的docker-entrypoint-initdb.d路径，mysql容器会自动初始化表结构以及一些原始数据！

1.3 spring-boot程序

controller:

package com.example.docker_compose;
import org.springframework.beans.factory.annotation.autowired;
import org.springframework.jdbc.core.jdbctemplate;
import org.springframework.web.bind.annotation.requestmapping;
import org.springframework.web.bind.annotation.responsebody;
import org.springframework.web.bind.annotation.restcontroller;
@restcontroller
@requestmapping("/user")
public class controller {
    @autowired
    jdbctemplate jdbctemplate;
    @requestmapping("/list")
    @responsebody
    public object users(){
        return jdbctemplate.queryforlist("select * from users");
    }
}

application.properties配置：

spring.application.name=docker_compose #项目名
spring.datasource.url=jdbc:mysql://mysql容器名称:3306/数据库名称
spring.datasource.username=root # mysql用户名
spring.datasource.password=1111 # mysql密码

注意：

jdbc的url一定不能错，尤其是容器名称，后面我们定义容器网络，它会根据容器名称寻址（域名解析）。
docker compose 未自定义容器名时，容器会生成默认名称，规则为：[项目目录名]-[服务名]-[容器启动序号]（例如 p12_spring-mysql-1）
默认情况下，容器名称会随项目目录、启动次数变化，不建议直接用于 jdbc 配置；可以使用container_name自定义容器名称（后续会讲到）

1.4 nginx配置文件

# 文件名：myapp.conf（只要是.conf后缀都行）
server{ 
  listen 80; #容器内部监听80端口
  access_log off; # 关闭日志记录-减少io
  location / {# /所有请求，转发到user/list路径下
    proxy_pass http://myapp:8080/user/list; 
  }
}

小提示：
myapp.conf文件配置到容器/etc/nginx/conf.d可以实现路径转发

二、spring-boot程序打包

2.1 生成jar包

spring-boot项目编写完后，点击mave的clear清理缓存，然后点击package打包：

提示build success后，target路径下会有一个编译好的jar包：

2.2 通过scp命令上传到服务器

首先创建好服务器这边的项目路径：

pwd
/root/docker_stu/docker_compose/p11_blog

后续docker-compose默认会以p11_blog命名容器

然后直接在控制台（windows终端或者idea的控制台都可以）
执行scp命令：

scp jar包路径.jar 用户名(一般都是root)@你的公网ip:你的服务器项目路径

执行完命令会提示输入服务器密码，输入完成后，即可开始传输jar包

三、创建宿主机依赖路径、文件

3.1 宿主机mysql初始化文件

cd 回到项目路径
mkdir mysqlinit
cd ./mysqlinit
vim init.sql

然后把刚才我们提及到的1.2中的init.sql拷贝到这个路径（宿主机路径）

3.2 宿主机nginx配置文件

cd 回到项目路径
mkdir -p ./nginxhome/conf.d 
cd ./nginxhome/conf.d
vim myapp.conf

把1.4中的myapp.conf配置文件拷贝过去即可，功能1.4已经讲过，这里不过多赘述

四、定义docker-compose.yml

注意：
docker-compose.yml直接放到项目路径，那么其工作目录默认就是项目路径，下面的存储卷路径默认以项目路径为基准；

4.1 nginx容器定义

# 文件名：docker-compose.yml
services:
  web:
    image: nginx:latest
    volumes:
      - ./nginxhome/conf.d:/etc/nginx/conf.d #简洁写法，定义绑定卷
    ports:
      - 8080:80 #端口映射
    expose:
      - 80 #声明容器内部开放端口

4.2 mysql容器定义

# 文件名：docker-compose.yml
services:
  web:
  ...省略
  mysql:
    image: mysql:5.7
    container_name: mysql_container #定义容器名称
    volumes:
      - type: bind #这是完整方式定义绑定卷
        source: ./mysqlinit/
        target: /var/lib/mysql/
        read_only: true
        volume:
          nocopy: false  #若宿主机目录为空，复制容器数据到宿主机目录

4.3 spring-boot容器定义

这里我们使用openjdk镜像去驱动jar包：

# 文件名：docker-compose.yml
services:
  web:
  ....省略
  myapp:
    image: openjdk:17 #这里版本，使用和自己java版本一致的就行
    volumes:
      - ./app:/app/ #简洁定义绑定卷
    command: java -jar /app/docker_compose-0.0.1-snapshot.jar #设置启动命令

4.4容器依赖关系与健康检查

4.4.1 概述

回到第一节的目标上，我们需要启动一个spring-boot程序，查询user表内容，并且通过nginx实现反向代理；这里涉及多个容器：myapp、mysql、nginx；
那么容器之间一定存在这样的依赖关系：

myapp查询user表需要mysql
nginx反向代理myapp，前提是myapp要优先于nginx启动

docker-compose.yml提供了depends_on来实现这种容器之间的依赖需求。
此外这还引入了一个问题：如何判断依赖的容器是否成功启动呢？
docker-compose.yml也很贴心，给我们提供了healthcheck来自定义容器如何算是启动成功；
接下来，我会接着用这个案例来具体显示其用法

4.4.2 健康检查

根据4.4.1的说明myapp和mysql是被依赖的容器，那么它们两个一定需要健康检查（虽然nginx健康检出是不必须的，但是建议也加上，实现增肌）

#文件名：docker-compose.yml
services:
  mysql:
    healthcheck:
      test: mysql -u root -p1111 -e 'select 1;' #mysql自带的健康检查
      interval: 10s
        timeout: 10s
        retries: 5
  myapp:
    healthcheck:
      test: ["cmd", "sh", "-c", "jps -l | grep 'docker_compose-0.0.1-snapshot.jar' || exit 1"] #该命令openjdk自带的
      interval: 10s #检查间隔时间
      timeout: 5s # 定义超时时间
      retries: 5 # 重试最大次数
      start_period: 30s #给一个启动缓冲时间，30s之后才开始记录重试次数

4.4.3 容器依赖关系（也叫容器拓扑）

以下为省略写法（只含有依赖定义）：

#文件名：docker-compose.yml
services:
  web:
    depends_on:
      mysql:
        condition: service_healthy #condition不为headlthy则容器编排会报错
      myapp:
        condition: service_healthy
  myapp:
    depends_on:
      mysql:
        condition: service_healthy

condition健康类型的选项：

状态值	含义
`service_healthy`	依赖的服务容器状态为 `healthy`（健康检查通过）
`service_started`	依赖的服务容器只是 `running`（进程启动，不校验健康状态）—— 这是默认值
`service_completed_successfully`	依赖的服务容器已 `exited` 且退出码为 0（适用于一次性任务，如初始化脚本）

4.5 容器网络定义

还是回到第一节讲到的目标，配置spring-boot+mysql+nginx容器编排，网络类型毫无疑问，bridge是最合适的；所以我们可以定义一个自定义bridge网络，让三个容器都加入该自定义网络即可：

#文件名：docker-compose.yml
services:
  web:
    image: nginx:latest #指定容器的nginx镜像版本
    volumes:
      - ./nginxhome/conf.d:/etc/nginx/conf.d #简洁写法，定义绑定卷
    ports:
      - 8080:80 #端口映射
    expose:
      - 80 #声明容器内部开放端口
    depends_on:
      mysql:
        condition: service_healthy
      myapp:
        condition: service_healthy
    networks:
      - mybridge_network
  mysql:
    image: mysql:5.7
    environment:
      mysql_root_password: 1111
    container_name: mysql_container
    volumes:
      - type: bind #这是完整定义方式
        source: ./mysql/mysqllib/
        target: /var/lib/mysql/ #mysql元数据存储在这里
        read_only: false
        volume:
          nocopy: false
      - type: bind
        source: ./mysql/mysqlinit
        target: /docker-entrypoint-initdb.d/ #自动根据ini.sql初始化数据
    healthcheck:        
      test: mysql -u root -p1111 -e 'select 1;'
      interval: 10s
      timeout: 10s
      retries: 5
    networks:
      - mybridge_network
  myapp:
    image: openjdk:17
    volumes:
      - ./app:/app/
    command: java -jar /app/docker_compose-0.0.1-snapshot.jar
    healthcheck:
      test: ["cmd", "sh", "-c", "jps -l | grep 'docker_compose-0.0.1-snapshot.jar' || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 5
      start_period: 30s
    networks:
      - mybridge_network
networks:
  mybridge_network:
    driver: bridge

五、启动docker-compose.yml

启动所有容器：

cd 回到项目路径
docker compose up -d
warn[0000] mount of type `bind` should not define `volume` option 
[+] running 3/3
 ✔ container p11_blog-myapp-1  healthy                                                                                                                                6.5s 
 ✔ container mysql_container   healthy                                                                                                                               11.0s 
 ✔ container p11_blog-web-1    started                                                                                                                               13.0s 
root@iz2ze8ve39i30yl0dhbqnez:~/docker_stu/docker_compose/p11_blog# docker ps
container id   image          command                  created          status                    ports                                     names
bf059297e184   nginx:latest   "/docker-entrypoint.…"   48 seconds ago   up 37 seconds             0.0.0.0:8080->80/tcp, [::]:8080->80/tcp   p11_blog-web-1
82746d8b74d1   openjdk:17     "java -jar /app/dock…"   48 seconds ago   up 48 seconds (healthy)                                             p11_blog-myapp-1
a69b1ac6de7d   mysql:5.7      "docker-entrypoint.s…"   48 seconds ago   up 48 seconds (healthy)   3306/tcp, 33060/tcp                       mysql_container

查看地址：公网ip:8080
成功回显数据：

查看网络创建情况：

docker network ls |grep  p11
1de554ab3031   p11_blog_mybridge_network   bridge    local
docker compose down
[+] running 4/4
 ✔ container p11_blog-web-1           removed                                                                                                                         1.3s 
 ✔ container mysql_container          removed                                                                                                                         4.6s 
 ✔ container p11_blog-myapp-1         removed                                                                                                                         1.3s 
 ✔ network p11_blog_mybridge_network  removed                                                                                                                         0.3s 
root@iz2ze8ve39i30yl0dhbqnez:~/docker_stu/docker_compose/p11_blog# docker network ls |grep  p11 #停止并且删除容器后，再次查看，网络也已经被删除了

到此这篇关于spring boot+nginx+mysql容器化实战指南的文章就介绍到这了,更多相关spring boot nginx mysql容器化内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！

Spring Boot+Nginx+MySQL容器化实战指南

2026年03月21日 • Java •我要评论