使用Docker容器化部署Java Spring Boot应用的完整指南

引言

在当今的软件开发领域，容器化技术已经成为一种主流的部署方式。Docker作为容器化技术的代表，以其轻量级、可移植性强和易于管理等优势，受到了广大开发者的青睐。本文将详细介绍如何使用Docker容器化部署Java Spring Boot应用，帮助您从零开始掌握这一技能。

1. 环境准备

首先，确保您的开发环境已经安装了以下工具：

  • Java JDK：建议使用OpenJDK 11或更高版本。
  • Maven：用于构建和打包Java项目。
  • Docker：用于创建和管理容器。
安装Docker

如果您还没有安装Docker，可以按照以下步骤进行安装：

    Windows：

    • 下载并安装Docker Desktop：Docker Desktop for Windows

    macOS：

    • 下载并安装Docker Desktop：Docker Desktop for macOS

    Linux：

    • 使用包管理器安装，例如在Ubuntu上： 
      
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io
sudo systemctl start docker
sudo systemctl enable docker

2. 创建Spring Boot应用

我们将从创建一个简单的Spring Boot应用开始。如果您已经有现成的Spring Boot项目，可以跳过这一步。

使用Spring Initializr创建项目
  1. 访问Spring Initializr。
  2. 选择项目元数据：
    • Project: Maven Project
    • Language: Java
    • Spring Boot: 2.5.0
  3. 项目依赖选择：
    • Spring Web
  4. 点击“GENERATE”，下载并解压项目。
编写简单的REST API

打开项目，编辑src/main/java/com/example/demo/DemoApplication.java文件：

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
@RestController
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }

    @GetMapping("/")
    public String home() {
        return "Hello, Docker!";
    }
}

3. 构建并测试Spring Boot应用

在项目根目录下执行以下命令，构建并运行Spring Boot应用：

mvn clean package
java -jar target/demo-0.0.1-SNAPSHOT.jar

4. 创建Dockerfile

在项目根目录下创建一个名为Dockerfile的文件，内容如下：

# 基础镜像
FROM openjdk:11-jdk-slim as build

# 设置工作目录
WORKDIR /app

# 复制pom.xml和src目录到工作目录
COPY pom.xml src ./src

# 构建项目
RUN mvn clean package

# 复制打包后的jar文件到工作目录
COPY target/demo-0.0.1-SNAPSHOT.jar app.jar

# 运行环境
FROM openjdk:11-jre-slim

# 复制构建阶段的jar文件到运行环境
COPY --from=build /app/app.jar /app/app.jar

# 设置工作目录
WORKDIR /app

# 暴露8080端口
EXPOSE 8080

# 启动命令
ENTRYPOINT ["java", "-jar", "app.jar"]

5. 构建Docker镜像

在项目根目录下执行以下命令，构建Docker镜像：

docker build -t spring-boot-docker-demo .

6. 运行Docker容器

使用以下命令运行Docker容器：

docker run -p 8080:8080 spring-boot-docker-demo

7. 高级配置

使用Docker Compose

对于更复杂的应用，可以使用Docker Compose来管理多个容器。创建一个名为docker-compose.yml的文件：

version: '3'
services:
  app:
    build: .
    ports:
      - "8080:8080"
  db:
    image: postgres:13
    environment:
      POSTGRES_DB: demo
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password

使用以下命令启动服务：

docker-compose up
环境变量管理

在Docker中管理环境变量可以通过以下方式：

    在Dockerfile中使用ENV指令：

    ENV SPRING_PROFILES_ACTIVE=prod

    在运行容器时传递环境变量：

    docker run -e SPRING_PROFILES_ACTIVE=prod -p 8080:8080 spring-boot-docker-demo

8. 部署到生产环境

推送镜像到Docker Hub

首先，登录Docker Hub：

docker login

标记镜像并推送：

docker tag spring-boot-docker-demo yourusername/spring-boot-docker-demo
docker push yourusername/spring-boot-docker-demo
在生产服务器上拉取并运行

在生产服务器上执行以下命令：

docker pull yourusername/spring-boot-docker-demo
docker run -d -p 8080:8080 yourusername/spring-boot-docker-demo

结语

通过本文的详细指导，您已经学会了如何使用Docker容器化部署Java Spring Boot应用。从环境准备到构建、测试、部署，每一步都进行了详细的讲解。希望这篇文章能帮助您在实际项目中顺利应用Docker技术，提升开发效率和部署便捷性。