Java开发必备:DockerCompose实战指南

原创已于 2025-04-20 17:26:11 修改 · 1.5k 阅读

27 ·

CC 4.0 BY-SA版权

文章标签：

#java #开发语言

于 2025-03-10 21:11:18 首次发布

Java知识专栏收录该内容

338 篇文章

订阅专栏

一、Docker Compose 基础入门

1.1 什么是 Docker Compose

1.2 安装 Docker Compose

二、构建 Java 项目的 Docker 镜像

三、用 Docker Compose 编排多容器

3.1 编写 docker - compose.yml 文件

3.2 启动与停止容器

四、在 Docker Compose 中配置环境变量

五、使用 Docker Compose 进行开发与测试

在 Java 开发领域，Docker Compose 正迅速成为项目部署与环境管理的得力助手。它允许开发者通过一个简单的配置文件，轻松定义并管理多个 Docker 容器的协同工作，极大地提升了开发、测试与部署的效率。接下来，让我们深入探索 Java 开发中 Docker Compose 的用法与优势。

一、Docker Compose 基础入门

1.1 什么是 Docker Compose

Docker Compose 本质上是一个用于定义和运行多容器 Docker 应用程序的工具。在 Java 项目里，常常涉及数据库、Web 服务器、消息队列等多个组件，Docker Compose 能把这些组件各自封装在独立的 Docker 容器中，并协调它们的运行，确保整个系统无缝协作。比如一个典型的 Java Web 项目，后端服务可能依赖 MySQL 数据库存储数据，借助 Docker Compose，就能一键启动后端 Java 应用容器与 MySQL 数据库容器，保障两者互联互通。

1.2 安装 Docker Compose

安装 Docker Compose 的过程十分便捷。在 Linux 系统下，可通过官方脚本快速安装。以 Ubuntu 为例，在终端执行以下命令：

sudo curl -L "https://github.com/docker/compose/releases/download/2.17.2/docker - compose - $(uname - s)-$(uname - m)" -o /usr/local/bin/docker - compose
sudo chmod +x /usr/local/bin/docker - compose

对于 Windows 和 MacOS 系统，直接前往 Docker 官网下载对应的安装包，按照提示一步步完成安装即可。安装完成后，在终端输入docker - compose --version，若能正确显示版本号，就说明安装成功了。

二、构建 Java 项目的 Docker 镜像

在使用 Docker Compose 前，得先为 Java 项目构建 Docker 镜像。以一个简单的 Spring Boot 项目为例，假设项目结构如下：

my - spring - boot - app/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/
│   │   │       └── example/
│   │   │           └── Application.java
│   │   └── resources/
│   │       └── application.properties
│   └── test/
├── pom.xml
└── Dockerfile

其中，Dockerfile用于构建 Docker 镜像，内容如下：

# 使用官方的OpenJDK 17作为基础镜像
FROM openjdk:17 - jdk - slim

# 将项目的JAR文件复制到镜像中的/app目录
COPY target/my - spring - boot - app - 1.0.0.jar /app/

# 工作目录设置为/app
WORKDIR /app

# 暴露应用的端口，假设Spring Boot应用监听8080端口
EXPOSE 8080

# 启动命令，运行JAR文件
CMD ["java", "-jar", "my - spring - boot - app - 1.0.0.jar"]

构建镜像时，在项目根目录下打开终端，执行命令：

docker build -t my - spring - boot - app:1.0.0.

这里，-t参数用于指定镜像的标签，格式为镜像名:版本号，最后的.表示构建上下文为当前目录。

三、用 Docker Compose 编排多容器

3.1 编写 docker - compose.yml 文件

假设我们的 Java 项目除了自身应用，还依赖 MySQL 数据库。这时，就需要编写docker - compose.yml文件来编排这两个容器。以下是一个简单示例：

version: '3.9'
services:
  app:
    build:
      context:.
      dockerfile: Dockerfile
    ports:
      - "8080:8080"
    depends_on:
      - db
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: rootpassword
      MYSQL_DATABASE: mydb
      MYSQL_USER: myuser
      MYSQL_PASSWORD: mypassword
    ports:
      - "3306:3306"

在这个文件中：

version指定了 Docker Compose 文件的版本。
services下定义了两个服务，app代表我们的 Java 应用，通过build指定了构建上下文和Dockerfile路径，ports将容器内的 8080 端口映射到宿主机的 8080 端口，depends_on表明app服务依赖于db服务，即db服务会先启动。
db服务使用官方的 MySQL 8.0 镜像，通过environment设置了数据库的 root 密码、数据库名、用户名和密码，ports将容器内的 3306 端口映射到宿主机的 3306 端口。

3.2 启动与停止容器

编写好docker - compose.yml文件后，在文件所在目录的终端执行以下命令启动容器：

docker - compose up - d

-d参数表示以后台守护进程的方式运行容器。若想停止正在运行的容器，执行：

docker - compose down

这会停止并移除所有由该docker - compose.yml文件启动的容器。

四、在 Docker Compose 中配置环境变量

在 Java 项目开发与部署过程中，环境变量发挥着重要作用，比如配置数据库连接字符串、应用的密钥等。在docker - compose.yml文件里，可以通过environment字段为容器设置环境变量。

假设我们的 Spring Boot 应用需要读取application - prod.properties文件来获取生产环境的配置，并且要设置一个SPRING_PROFILES_ACTIVE环境变量来指定当前使用的配置文件。对docker - compose.yml文件中的app服务进行如下修改：

services:
  app:
    build:
      context:.
      dockerfile: Dockerfile
    ports:
      - "8080:8080"
    depends_on:
      - db
    environment:
      - SPRING_PROFILES_ACTIVE=prod

这样，在容器启动时，Spring Boot 应用就能读取到application - prod.properties文件中的配置。

五、使用 Docker Compose 进行开发与测试

5.1 开发环境管理

在开发 Java 项目时，团队成员的开发环境可能存在差异，这会导致一些不必要的问题。借助 Docker Compose，所有成员只需在项目根目录下执行docker - compose up，就能一键搭建与项目依赖完全一致的开发环境，确保大家的开发环境统一，减少因环境不一致引发的问题。

5.2 自动化测试

在项目的 CI/CD 流程中，Docker Compose 也大有用武之地。例如，在进行自动化测试时，可通过 Docker Compose 启动测试所需的所有服务，包括数据库、消息队列等。测试完成后，再用docker - compose down快速清理环境，保障测试环境的干净与可重复性。以下是一个简单的 Maven 构建脚本示例，用于在 CI/CD 流程中使用 Docker Compose 启动测试环境：

<build>
  <plugins>
    <plugin>
      <groupId>com.spotify</groupId>
      <artifactId>docker - maven - plugin</artifactId>
      <version>1.2.0</version>
      <executions>
        <execution>
          <id>start - test - containers</id>
          <phase>pre - integration - test</phase>
          <goals>
            <goal>start</goal>
          </goals>
          <configuration>
            <useCompose>true</useCompose>
            <composeFile>src/test/resources/docker - compose - test.yml</composeFile>
          </configuration>
        </execution>
        <execution>
          <id>stop - test - containers</id>
          <phase>post - integration - test</phase>
          <goals>
            <goal>stop</goal>
          </goals>
          <configuration>
            <useCompose>true</useCompose>
            <composeFile>src/test/resources/docker - compose - test.yml</composeFile>
          </configuration>
        </execution>
      </executions>
    </plugin>
  </plugins>
</build>

在这个示例中，Maven 插件在pre - integration - test阶段启动src/test/resources/docker - compose - test.yml文件定义的测试容器，在post - integration - test阶段停止这些容器。

六、常见问题与解决方案

6.1 容器启动失败

若容器启动失败，首先检查docker - compose.yml文件的语法是否正确，可通过docker - compose config命令验证。若语法无误，查看容器的日志来排查问题，使用docker - compose logs命令能查看所有容器的日志，也可通过docker - compose logs <容器名>查看单个容器的日志。例如，若db容器启动失败，执行docker - compose logs db，从日志中找出诸如数据库配置错误、端口冲突等问题。

6.2 网络通信问题

有时，容器之间可能无法正常通信。这可能是因为网络配置有误，或者容器内的服务监听地址不正确。在docker - compose.yml文件中，确保各服务的端口映射正确，且服务内部监听的是容器内的正确地址。比如，Spring Boot 应用应监听0.0.0.0，而非127.0.0.1，这样其他容器才能访问该应用。