Java 后端 / 系统课时

使用 Docker Compose 联调

使用 Docker Compose 联调

本课解决企业后端开发中多服务本地联调复杂的问题,最终能够使用 Docker Compose 编排 Spring Boot、PostgreSQL、Redis、Kafka 和监控组件,并验证服务间网络与数据持久化。

学习目标

  • 理解 Compose 中服务、网络和数据卷的关系
  • 掌握多组件环境的编排配置方法
  • 能够定位容器启动、连接和持久化问题

设计多服务联调结构

企业级 Spring Boot 应用通常依赖数据库、缓存、消息队列和监控系统。Docker Compose 可以通过统一配置文件描述这些组件,让开发环境快速复现生产依赖关系。

服务之间默认通过 Compose 创建的内部网络通信,数据库和缓存数据则需要通过数据卷保存,避免容器删除后数据丢失。

Docker Compose 多服务联调架构图

编写 Compose 配置

以下是一个简化联调环境示例,展示应用依赖和持久化配置。

yaml
services:
  app:
    image: spring-app:<ID>
    ports:
      - "<PORT>:<PORT>"
    depends_on:
      - postgres
      - redis
      - kafka

  postgres:
    image: postgres:16
    environment:
      POSTGRES_PASSWORD: example
    volumes:
      - pg-data:/var/lib/postgresql/data

  redis:
    image: redis:7

  kafka:
    image: apache/kafka:<ID>

volumes:
  pg-data:

启动环境:

bash
docker compose up -d

预期输出

text
Container app started
Container postgres started
Container redis started
Container kafka started

验证网络与持久化

Compose 服务之间使用服务名解析。例如应用连接数据库时,应使用 postgres 作为主机名,而不是本机地址。

bash
docker compose ps

预期输出

text
NAME              STATUS
app               running
postgres          running
redis             running
kafka             running

停止并重新启动环境后,需要确认 PostgreSQL 数据仍存在,这说明数据卷配置生效。

排查联调失败问题

容器环境出现问题时,应按照服务状态、网络连接、配置参数、数据持久化顺序定位。

常见原因包括:应用启动早于数据库就绪、端口映射错误、容器内部地址使用错误、数据卷权限不足等。查看日志可以快速确认启动阶段失败原因:

bash
docker compose logs app

预期结果

text
Application started successfully
按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

使用 Docker Compose 联调

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通