中州养老项目部署

0 阅读6分钟

中州养老项目 · Docker 部署

从「标准部署流程」到「底层原理」的完整复盘。
部署根目录:/opt/zzyl,编排方式:docker compose up -d。


一、整体架构

项目由 4 个服务组成,全部接入同一个自定义网络,容器之间用服务名互访,宿主机运维操作用容器名。

服务服务名 / 容器名镜像作用
前端 + 网关zzyl-nginxnginx:latest托管前端静态资源,把 /prod-api/ 反向代理到后端
后端zzyl-backendJDK + zzyl-admin.jarSpring Boot 业务服务,监听 8080
数据库zzyl-mysqlmysql业务数据,用 ry-zzyl.sql 初始化
缓存zzyl-redisredis缓存,设置访问密码

二、标准部署流程(必会)

核心心法:先准备好宿主机上所有的目录、配置和资源,最后再一键拉起容器。 不仅是我们这个项目,在实际生产环境的标准流水线里,通常也是先准备好所有环境配置,最后再一键拉起容器。

第一步:在宿主机创建标准的目录结构

不要什么都堆在 /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 配置

  1. 把打包好的前端产物(index.html、assets 文件夹)传到 /opt/zzyl/nginx/html/。
  2. 在 /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 脚本

  1. 把 zzyl-admin.jar 传到 /opt/zzyl/backend/。
  2. 把 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重启单个容器使配置生效