中州养老项目 · Docker 部署
从「标准部署流程」到「底层原理」的完整复盘。
部署根目录:/opt/zzyl,编排方式:docker compose up -d。
一、整体架构
项目由 4 个服务组成,全部接入同一个自定义网络,容器之间用服务名互访,宿主机运维操作用容器名。
| 服务 | 服务名 / 容器名 | 镜像 | 作用 |
|---|---|---|---|
| 前端 + 网关 | zzyl-nginx | nginx:latest | 托管前端静态资源,把 /prod-api/ 反向代理到后端 |
| 后端 | zzyl-backend | JDK + zzyl-admin.jar | Spring Boot 业务服务,监听 8080 |
| 数据库 | zzyl-mysql | mysql | 业务数据,用 ry-zzyl.sql 初始化 |
| 缓存 | zzyl-redis | redis | 缓存,设置访问密码 |
二、标准部署流程(必会)
核心心法:先准备好宿主机上所有的目录、配置和资源,最后再一键拉起容器。 不仅是我们这个项目,在实际生产环境的标准流水线里,通常也是先准备好所有环境配置,最后再一键拉起容器。
第一步:在宿主机创建标准的目录结构
不要什么都堆在 /opt/zzyl 里,要有清晰的分类:
mkdir -p /opt/zzyl/nginx/conf.d
mkdir -p /opt/zzyl/nginx/html
mkdir -p /opt/zzyl/mysql/data
mkdir -p /opt/zzyl/redis/data
mkdir -p /opt/zzyl/backend
mkdir -p /opt/zzyl/sql # 第三步放 ry-zzyl.sql,别漏了
第二步:上传前端静态资源并修改 Nginx 配置
- 把打包好的前端产物(
index.html、assets文件夹)传到/opt/zzyl/nginx/html/。 - 在
/opt/zzyl/nginx/conf.d/目录下,新建并编辑zzyl.conf文件:- 把
location /指向静态资源; - 把
location /prod-api/用proxy_pass指向后端容器名/服务名http://zzyl-backend:8080/。
- 把
参考配置:
server {
listen 80;
server_name localhost;
location / {
root /usr/share/nginx/html;
index index.html;
try_files $uri $uri/ /index.html; # 支持前端 history 路由
}
location /prod-api/ {
proxy_pass http://zzyl-backend:8080/; # 写服务名,靠 Docker DNS 解析
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
}
}
第三步:上传后端 Jar 包与 SQL 脚本
- 把
zzyl-admin.jar传到/opt/zzyl/backend/。 - 把
ry-zzyl.sql传到/opt/zzyl/sql/。
第四步:编写 docker-compose.yml
在这个 YAML 文件里,需要把上面的目录全部挂载进去,例如 Nginx 部分:
zzyl-nginx:
image: nginx:latest
volumes:
- ./nginx/html:/usr/share/nginx/html # 挂载前端
- ./nginx/conf.d:/etc/nginx/conf.d # 挂载配置文件
第五步:一键启动与验证
所有文件就位后,在 /opt/zzyl 目录下执行:
docker compose up -d
三、核心知识点复盘
3.1 Docker 网络与服务发现
docker network ls # 列出所有 docker 网络
docker network inspect 网络名 # 看该网络里面有哪些容器
自定义网络:只要服务在同一个网络下,就可以相互用服务名访问。
⚠️ 最容易踩的坑:服务名 vs 容器名,为防止出错docker-compose.yml文件中可以将服务名和容器名可设置为同一个
| 场景 | 用什么 | 例子 | 说明 |
|---|---|---|---|
| Java 程序内部访问 DB / Redis(配置文件里) | 服务名 | host: my-db-service | 走 Docker 内置 DNS。如果写 my-container(容器名)反而会报错连不上 |
| 宿主机终端做运维操作(看日志、进容器、重启) | 容器名 | docker logs my-container | 必须用容器名 |
一句话记忆:对内(容器间通信)用服务名,对外(终端敲命令)用容器名。
对应到本项目,后端配置里应当是:
spring:
datasource:
url: jdbc:mysql://zzyl-mysql:3306/zzyl?... # host 必须写服务名 zzyl-mysql
redis:
host: zzyl-redis # 同样写服务名
password: 123456
3.2 环境变量:MySQL 和 Redis 不一样
MySQL 官方镜像原生支持通过环境变量设置密码:
zzyl-mysql:
environment:
MYSQL_ROOT_PASSWORD: 123456
MYSQL_ROOT_HOST: '%'
MYSQL_ROOT_HOST: '%':保证外部设备可以连接数据库(DataGrip),允许 root 从任意主机连入。
Redis 官方镜像默认不会自动读取 REDIS_PASSWORD 这种环境变量,必须用启动命令显式传参:
zzyl-redis:
command: redis-server --requirepass 123456
| 镜像 | 设置密码的正确方式 | 是否认环境变量 |
|---|---|---|
| MySQL 官方镜像 | MYSQL_ROOT_PASSWORD 环境变量 | ✅ 原生支持 |
| Redis 官方镜像 | command: redis-server --requirepass xxx | ❌ 写 REDIS_PASSWORD 无效 |
3.3 目录挂载(volumes)的本质与坑
语法:本地指定路径:文件在docker中的路径
Docker 的挂载(volumes)本质上是把宿主机上的一个目录或文件,直接「映射」到容器内部。
⚠️ 坑:如果你在启动容器之前,宿主机上根本没有这个文件,Docker 可能会报错(或者建一个空文件夹),导致 Nginx 启动失败。
所以标准顺序必须是:先建目录、先放配置和产物 → 最后 docker compose up -d。
3.4 「挂载目录」vs「挂载文件」,以及 Nginx 优雅的地方
Nginx 官方镜像里自带了主配置文件 /etc/nginx/nginx.conf,其中有一句非常关键的代码:
include /etc/nginx/conf.d/*.conf;
- 当你把宿主机上空荡荡的
conf.d文件夹挂载到容器里时,容器里的主配置一看:"哦,conf.d文件夹现在是空的,那我就只加载主配置,不加载子配置"。 → 所以即使zzyl.conf还没写,Nginx 依然能正常启动(能返回默认的欢迎页面)。 - 当你把写好的
zzyl.conf放进去后,Nginx 重启或重载时,主配置一读,发现多了一个.conf文件,就自动把这段反向代理规则加载进去。
这就是「挂载目录」和「挂载文件」最大的区别:容器可以先起来,配置后补,全程不用重建镜像、不用重建容器。
四、完整 docker-compose.yml 参考整合版
⚠️ 以下是根据上面所有知识点整理的参考示例,并非项目原始文件;镜像版本、端口、SQL 初始化方式等请按实际环境调整。
version: '3.8'
services:
zzyl-nginx:
image: nginx:latest
container_name: zzyl-nginx
ports:
- "80:80"
volumes:
- ./nginx/html:/usr/share/nginx/html # 挂载前端
- ./nginx/conf.d:/etc/nginx/conf.d # 挂载配置文件
depends_on:
- zzyl-backend
networks:
- zzyl-net
zzyl-backend:
image: openjdk:8-jdk # 示例镜像,按实际调整
container_name: zzyl-backend
volumes:
- ./backend:/app
working_dir: /app
command: java -jar zzyl-admin.jar
depends_on:
- zzyl-mysql
- zzyl-redis
networks:
- zzyl-net
zzyl-mysql:
image: mysql:8.0
container_name: zzyl-mysql
environment:
MYSQL_ROOT_PASSWORD: 123456
MYSQL_ROOT_HOST: '%' # 允许 DataGrip 等外部工具连接
volumes:
- ./mysql/data:/var/lib/mysql
- ./sql:/docker-entrypoint-initdb.d # 首次启动自动执行 ry-zzyl.sql
ports:
- "3306:3306"
networks:
- zzyl-net
zzyl-redis:
image: redis
container_name: zzyl-redis
command: redis-server --requirepass 123456 # 不能靠 REDIS_PASSWORD 环境变量
volumes:
- ./redis/data:/data
ports:
- "6379:6379"
networks:
- zzyl-net
networks:
zzyl-net:
driver: bridge
五、💡 面试加分点:如果改了 zzyl.conf 会怎样?
面试官可能会问:"如果你上线后发现 Nginx 配置写错了,需要修改,你怎么做?"
参考回答(展现运维经验):
"因为我是通过数据卷挂载的配置文件,我只需要在宿主机上用
vim修改/opt/zzyl/nginx/conf.d/zzyl.conf,然后执行docker exec zzyl-nginx nginx -s reload,或者直接docker restart zzyl-nginx,新的配置就会立刻生效,完全不需要重启整个后端或其他容器,实现了配置与容器的解耦,业务也不会中断。"
为什么这个回答加分:
| 要点 | 说明 |
|---|---|
| 配置在宿主机、不在镜像里 | 改配置不需要重建镜像、不需要重新打包 |
nginx -s reload 平滑重载 | 不中断已有连接,比 restart 更优雅 |
| 只动 Nginx 一个容器 | 后端 / MySQL / Redis 完全无感知,实现配置与容器解耦 |
六、命令速查表
| 命令 | 作用 |
|---|---|
docker network ls | 列出所有 docker 网络 |
docker network inspect 网络名 | 查看该网络里有哪些容器 |
docker compose up -d | 后台一键拉起全部服务 |
docker compose down | 停止并移除全部服务 |
docker logs 容器名 | 查看日志(必须用容器名) |
docker exec zzyl-nginx nginx -s reload | 平滑重载 Nginx 配置 |
docker restart zzyl-nginx | 重启单个容器使配置生效 |