如何为Spring Boot员工管理项目创建工业级Docker镜像？

一、前置准备 #

• 本地已安装Docker和Maven 3.8+
• 确保项目能通过mvn clean package -DskipTests正常打包出可执行Jar包
• 若需联动MySQL，提前准备好MySQL容器或服务（建议用Docker网络统一管理）

二、优化应用配置（工业级部署必备） #

原配置文件中数据库地址写死localhost，在容器环境中无法访问外部/容器化的MySQL，需改为通过环境变量注入。修改application.properties：

server.port=8082
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
# 用环境变量替换硬编码配置，提升部署灵活性
spring.datasource.url=${DB_URL:jdbc:mysql://localhost:3306/empdb}
spring.datasource.username=${DB_USER:root}
spring.datasource.password=${DB_PASSWORD:your_default_password}
spring.jpa.show-sql=true
spring.jpa.hibernate.ddl-auto=update
spring.main.allow-bean-definition-overriding=true
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect

三、编写工业级Dockerfile（多阶段构建） #

在项目根目录创建Dockerfile，采用多阶段构建减少镜像体积，降低攻击面：

# 第一阶段：构建Jar包（使用Maven官方镜像，内置Java17）
FROM maven:3.8.6-openjdk-17 AS builder
WORKDIR /app
# 先复制POM.xml下载依赖（利用Docker缓存，避免代码修改后重复下载依赖）
COPY pom.xml .
RUN mvn dependency:go-offline -B
# 复制项目源码
COPY src ./src
# 打包可执行Jar包
RUN mvn clean package -DskipTests

# 第二阶段：运行Jar包（使用OpenJDK17精简镜像）
FROM openjdk:17-jdk-slim
WORKDIR /app
# 从构建阶段复制Jar包到运行环境
COPY --from=builder /app/target/employeemanagementservice-0.0.1-SNAPSHOT.jar app.jar
# 声明容器暴露端口（与应用配置的server.port一致）
EXPOSE 8082
# 设置启动命令
ENTRYPOINT ["java", "-jar", "app.jar"]

四、构建Docker镜像 #

在项目根目录执行命令：

docker build -t employee-management-service:v1 .

• -t：为镜像添加标签（格式：镜像名:版本号）
• .：指定Dockerfile所在目录为当前目录

五、运行Docker容器 #

方式1：单独运行（需确保MySQL可被容器访问） #

docker run -d \
  -p 8082:8082 \
  -e DB_URL=jdbc:mysql://<mysql_host>:3306/empdb \
  -e DB_USER=root \
  -e DB_PASSWORD=*s12 \
  --name employee-service \
  employee-management-service:v1

• -p：映射主机端口到容器端口（主机端口:容器端口）
• -e：设置环境变量，覆盖应用配置的默认值
• --name：为容器指定名称，方便管理

方式2：Docker Compose联动MySQL（推荐工业级部署） #

创建docker-compose.yml：

version: '3.8'
services:
  mysql:
    image: mysql:8.0
    container_name: mysql-db
    environment:
      MYSQL_ROOT_PASSWORD: *s12
      MYSQL_DATABASE: empdb
    ports:
      - "3306:3306"
    volumes:
      - mysql-data:/var/lib/mysql # 持久化MySQL数据
    networks:
      - employee-network

  employee-service:
    build: .
    container_name: employee-service
    environment:
      DB_URL: jdbc:mysql://mysql-db:3306/empdb
      DB_USER: root
      DB_PASSWORD: *s12
    ports:
      - "8082:8082"
    depends_on:
      - mysql # 确保MySQL启动后再启动应用
    networks:
      - employee-network

volumes:
  mysql-data:

networks:
  employee-network:
    driver: bridge

执行启动命令：

docker-compose up -d

六、验证镜像与容器 #

• 查看镜像：docker images，确认employee-management-service:v1存在
• 查看运行容器：docker ps，确认容器状态为Up
• 访问应用：在浏览器或Postman中访问http://localhost:8082，验证API是否正常

内容的提问来源于stack exchange，提问作者Vidyasagar Ramachandran