← 课程目录 🚀 从零到一
📐 学习维度 阶段5 · 第19章 Linux 部署与 Docker/K8s 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

19.3 docker-compose:一键编排多服务

审校 2026-09-25 · 素材来源:L37-Docker进阶、guanzi项目compose(脱敏改写)
📑 本篇章节导航 (共7节,点击直达)
一个文件描述整个技术栈depends_on 与 healthcheck:启动顺序的坑环境与配置:一个镜像跑多套环境数据、网络与日常操作踩坑清单面试怎么问一句话总结

一个 SpringBoot 服务的真实依赖清单:MySQL 存数据、Redis 做缓存(10 章)、RabbitMQ 传消息(11 章)、Nacos 做注册中心(16.2)。用 19.2 的裸 docker run,每个中间件一条长命令加五六个环境变量,新同事入职第一周都在背命令;换台机器搭环境,整套流程再来一遍,漏一个参数就是半天的玄学排障。docker-compose(用单个 YAML 文件定义并编排多个容器的工具)的答案:把整套技术栈写进一个文件,docker compose up -d 一条命令拉起全部——文件进 Git 仓库,环境即代码,任何人任何机器,clone 下来一条命令就是完整的技术栈。

一个文件描述整个技术栈


services:
  app:
    build: .                          # 用当前目录Dockerfile构建
    ports: ["8080:8080"]
    environment: { SPRING_PROFILES_ACTIVE: prod, DB_HOST: mysql }
    depends_on:
      mysql: { condition: service_healthy }   # 等健康再启动
    networks: [backend]
  mysql:
    image: mysql:8.0
    environment: { MYSQL_ROOT_PASSWORD: ${DB_PASSWORD} }  # .env注入
    volumes: [mysql-data:/var/lib/mysql]        # 数据持久化
    healthcheck:
      test: ["CMD", "mysqladmin", "ping", "-h", "localhost"]
      interval: 10s
      retries: 5
    networks: [backend]
volumes: { mysql-data: }
networks: { backend: }

这份文件值得逐段读:build 说明应用镜像现场构建;服务名就是 19.2 说的容器 DNS 名,DB_HOST: mysql 一行替代了所有 IP 配置;${DB_PASSWORD} 从同目录 .env 文件读取——密码不进 Git 仓库,这正是 18.1 讲的「凭据与代码分离」在部署层的落点。restart: unless-stopped 建议给每个服务配上:进程崩了自动拉起(19.1 systemd 的同款哲学,容器版的实现);顶层声明具名卷与网络,则让「用到的存储和网络」也成了文件里可 review 的一部分——编排文件的每一行都是基础设施的代码化描述,这份 yml 本身就是团队最准确的架构文档。

depends_on 与 healthcheck:启动顺序的坑

depends_on 有两档语义,区别是新手第一坑。不写 condition,只保证「容器启动了」,不管服务好不好——MySQL 进程起了但还在初始化,应用连上去直接拒绝连接,启动失败。加上 condition: service_healthy,compose 会等 healthcheck 通过才启动依赖方。healthcheck(周期性探测容器内服务是否就绪的机制)由 mysqladmin ping 这类命令定义:interval 十秒一探、连续失败五次才算病危——给初始化慢的服务留足缓冲,retries 与 interval 的乘积就是「最长容忍的启动时间」。这和 19.4 K8s 的探针是同一个思想:进程活着不等于服务可用。中间件如此,Spring Boot 应用自身也一样——用 actuator 的 health 端点做健康检查,编排器才知道你的服务什么时候「真能接流量」;应用侧再配上启动重试与连接池初始化容错,应用启动这条链路才算稳。反向的依赖同样存在:docker compose down 按依赖逆序停止——先停应用再停数据库,正好是优雅停机(19.1 的 SIGTERM 缓冲)的编排版实现。

环境与配置:一个镜像跑多套环境

compose 的组合拳是「镜像不变、环境变量变」:同一个 app 镜像,开发环境 SPRING_PROFILES_ACTIVE=dev 指向本地库,测试环境指向测试库。这呼应 14.3 的配置分离哲学——打包产物与配置解耦,配置以环境变量注入。实操里三招分层:docker-compose.yml 写通用骨架;docker-compose.override.yml 放开发差异(compose 默认自动合并,比如开发挂源码目录、多开一个调试端口);docker-compose.prod.yml 用 -f 显式指定生产差异(比如镜像换成仓库正式 tag、资源限额收紧)。多文件组合让「一份骨架多套环境」不用复制粘贴,改公共配置只改骨架一处,三套环境同时生效——这与 19.5 流水线「一份 Jenkinsfile 多环境部署」是同一条复用逻辑:差异外置、骨架收敛,是所有环境管理方案的共同底色。

数据、网络与日常操作

数据有两类挂法:具名卷(mysql-data 这类由 Docker 管理的持久卷)给数据库这类有状态服务;绑定挂载(./logs:/app/logs 直接映射宿主目录)给需要人工查看的日志和配置。中间件全有状态、应用无状态——这个「有状态下沉、无状态上浮」的分法,正是 19.4 K8s 区分 Deployment 与 StatefulSet 的判据。备份也别忘:具名卷里的数据 docker run --rm -v mysql-data:/data -v $PWD:/backup alpine tar czf /backup/mysql.tgz /data 一条命令打包带走,测试环境的宝贵造数经得起 down 折腾。日常命令四条覆盖 90% 操作:


docker compose up -d          # 全栈启动
docker compose ps             # 看各服务状态
docker compose logs -f app    # 追单个服务日志
docker compose down           # 全栈停止(-v连卷一起删,慎用)

单服务重建也常用:改完代码 docker compose up -d --build app 只重建应用不动数据库——依赖的中间件保持着热数据,开发迭代不付「重启动全家桶」的时间税。

最后划一条能力边界:compose 是单机编排,天生不懂「集群里哪台机器有空」——跨主机调度、多副本负载均衡、节点故障自愈,这些它做不了也不该做。什么时候从 compose 毕业:开发机、测试环境、单机撑得住的小规模生产,一直用它就是最优解;当服务要多副本高可用、发布要求滚动不中断、负载要多台机器分担时,就是上 19.4 K8s 的信号。工具没有高下,只有匹配——K8s 的能力是用十倍的复杂度换的,业务没到那个量级就别提前付那笔学费。

踩坑清单

面试怎么问

一句话总结

compose 把「五条 docker run 加二十个参数」压缩成一份可 review、可版本化的 YAML——服务名互访打通网络、healthcheck 校准顺序、环境变量分离配置,这是从「会跑容器」到「会编排容器」的成人礼,也是通往 K8s 的最后一级台阶。