Docker容器化部署Java Web项目实战指南-代码聚汇网

Docker容器化部署Java Web项目实战指南

SeigRobotics

1. Docker与Java Web项目部署概述

作为Java开发者，我们经常面临项目部署的挑战。传统部署方式需要手动配置服务器环境、安装依赖、处理各种兼容性问题，这个过程既耗时又容易出错。Docker的出现彻底改变了这一局面，它通过容器化技术将应用程序及其运行环境打包在一起，实现了"一次构建，处处运行"的理想状态。

以MySQL部署为例，传统方式需要：

下载对应系统的MySQL安装包
上传到服务器
安装依赖库
配置环境变量
初始化数据库
设置权限和配置文件

而使用Docker，只需一行命令：

bash复制docker run -d --name mysql -p 3307:3306 -e TZ=Asia/Shanghai -e MYSQL_ROOT_PASSWORD=123 mysql:8

这行命令背后，Docker完成了以下工作：

自动从Docker Hub下载MySQL 8.0镜像
创建并启动容器
设置时区为上海
配置root密码为123
将容器内的3306端口映射到宿主机的3307端口

2. Docker核心概念解析

2.1 镜像(Image)与容器(Container)

镜像是Docker的核心概念之一，可以理解为应用程序的打包格式。一个镜像包含：

应用程序本身
运行所需的系统库
环境变量配置
默认启动命令

容器则是镜像的运行实例，具有以下特点：

轻量级：共享主机内核，无需完整操作系统
隔离性：拥有独立的文件系统、网络和进程空间
可移植性：在任何支持Docker的环境中表现一致

2.2 Docker架构与工作流程

Docker采用客户端-服务器架构：

Docker客户端：我们使用的docker命令
Docker守护进程：负责构建、运行和管理容器
镜像仓库：存储和分发镜像（如Docker Hub）

典型工作流程：

mermaid复制graph TD
    A[编写Dockerfile] --> B[构建镜像]
    B --> C[推送镜像到仓库]
    C --> D[从仓库拉取镜像]
    D --> E[运行容器]

3. Docker基础操作实战

3.1 常用Docker命令详解

镜像管理

bash复制# 搜索镜像
docker search nginx

# 拉取镜像
docker pull nginx:1.20.2

# 查看本地镜像
docker images

# 删除镜像
docker rmi nginx:1.20.2

# 导出镜像到文件
docker save -o nginx.tar nginx:1.20.2

# 从文件导入镜像
docker load -i nginx.tar

容器管理

bash复制# 运行容器
docker run -d --name mynginx -p 80:80 nginx:1.20.2

# 查看运行中的容器
docker ps

# 查看所有容器（包括停止的）
docker ps -a

# 停止容器
docker stop mynginx

# 启动已停止的容器
docker start mynginx

# 重启容器
docker restart mynginx

# 删除容器
docker rm mynginx

# 强制删除运行中的容器
docker rm -f mynginx

# 查看容器日志
docker logs mynginx

# 实时查看日志
docker logs -f mynginx

# 进入容器shell
docker exec -it mynginx bash

3.2 数据持久化方案

容器本身是临时性的，默认情况下容器停止后数据会丢失。Docker提供了两种数据持久化方案：

数据卷(Volume)

bash复制# 创建数据卷
docker volume create mysql_data

# 查看数据卷
docker volume ls

# 使用数据卷
docker run -d --name mysql -v mysql_data:/var/lib/mysql mysql:8

# 删除数据卷
docker volume rm mysql_data

目录挂载

bash复制# 挂载主机目录
docker run -d --name mysql \
  -v /host/path:/container/path \
  mysql:8

# 示例：将主机的/data/mysql挂载到容器的/var/lib/mysql
docker run -d --name mysql \
  -v /data/mysql:/var/lib/mysql \
  mysql:8

注意：目录挂载时，主机路径必须以/或./开头，否则会被识别为数据卷名称

3.3 网络配置

Docker提供了多种网络模式：

基本网络命令

bash复制# 查看网络列表
docker network ls

# 创建自定义网络
docker network create mynet

# 查看网络详情
docker network inspect mynet

# 删除网络
docker network rm mynet

容器网络连接

bash复制# 运行容器并连接到指定网络
docker run -d --name web --network mynet nginx:1.20.2

# 将运行中的容器连接到网络
docker network connect mynet existing_container

# 断开容器与网络的连接
docker network disconnect mynet container_name

容器间通信

在同一网络中的容器可以通过容器名互相访问：

bash复制# 在web容器中ping db容器
docker exec -it web ping db

4. 自定义镜像构建

4.1 Dockerfile详解

Dockerfile是构建镜像的蓝图，包含一系列指令：

dockerfile复制# 基础镜像
FROM openjdk:17-jdk-slim

# 维护者信息
LABEL maintainer="dev@example.com"

# 设置工作目录
WORKDIR /app

# 复制文件
COPY target/myapp.jar app.jar

# 暴露端口
EXPOSE 8080

# 环境变量
ENV SPRING_PROFILES_ACTIVE=prod

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

4.2 多阶段构建

对于Java应用，可以使用多阶段构建减小镜像体积：

dockerfile复制# 构建阶段
FROM maven:3.8.4-openjdk-17 AS builder
WORKDIR /build
COPY pom.xml .
RUN mvn dependency:go-offline
COPY src/ ./src/
RUN mvn package -DskipTests

# 运行阶段
FROM openjdk:17-jdk-slim
WORKDIR /app
COPY --from=builder /build/target/myapp.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "app.jar"]

4.3 构建和运行镜像

bash复制# 构建镜像（注意最后的点表示当前目录）
docker build -t myapp:1.0 .

# 运行容器
docker run -d --name myapp -p 8080:8080 myapp:1.0

# 查看构建历史
docker history myapp:1.0

5. Java Web项目部署实战

5.1 单容器部署

以Spring Boot应用为例：

准备Dockerfile：

dockerfile复制FROM openjdk:17-jdk-slim
WORKDIR /app
COPY target/myapp.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "app.jar"]

构建和运行：

bash复制mvn clean package
docker build -t myapp:1.0 .
docker run -d --name myapp -p 8080:8080 myapp:1.0

5.2 多容器部署

典型Java Web项目通常需要：

应用容器
数据库容器
反向代理容器（如Nginx）

手动部署

bash复制# 创建网络
docker network create appnet

# 启动MySQL
docker run -d --name mysql --network appnet \
  -e MYSQL_ROOT_PASSWORD=secret \
  -e MYSQL_DATABASE=myapp \
  mysql:8

# 启动应用
docker run -d --name myapp --network appnet \
  -e SPRING_DATASOURCE_URL=jdbc:mysql://mysql:3306/myapp \
  -p 8080:8080 \
  myapp:1.0

# 启动Nginx
docker run -d --name nginx --network appnet \
  -p 80:80 \
  -v ./nginx.conf:/etc/nginx/nginx.conf \
  nginx:1.20.2

5.3 使用Docker Compose

docker-compose.yml示例：

yaml复制version: '3.8'

services:
  mysql:
    image: mysql:8
    container_name: mysql
    environment:
      MYSQL_ROOT_PASSWORD: secret
      MYSQL_DATABASE: myapp
    volumes:
      - mysql_data:/var/lib/mysql
    networks:
      - appnet

  app:
    build: .
    container_name: myapp
    environment:
      SPRING_DATASOURCE_URL: jdbc:mysql://mysql:3306/myapp
    ports:
      - "8080:8080"
    depends_on:
      - mysql
    networks:
      - appnet

  nginx:
    image: nginx:1.20.2
    container_name: nginx
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
    depends_on:
      - app
    networks:
      - appnet

networks:
  appnet:
    driver: bridge

volumes:
  mysql_data:

启动命令：

bash复制docker-compose up -d

6. 高级部署技巧

6.1 配置管理

推荐配置管理方式：

环境变量：适合简单配置
```
bash复制docker run -e KEY=VALUE
```

配置文件挂载：适合复杂配置

bash复制docker run -v /host/config:/container/config

配置中心：适合微服务架构

6.2 日志管理

最佳实践：

bash复制# 查看日志
docker logs container_name

# 实时日志
docker logs -f container_name

# 日志驱动配置（daemon.json）
{
  "log-driver": "json-file",
  "log-opts": {
    "max-size": "10m",
    "max-file": "3"
  }
}

# 将日志发送到外部系统
docker run --log-driver=syslog --log-opt syslog-address=udp://logserver:514

6.3 健康检查

Dockerfile中添加健康检查：

dockerfile复制HEALTHCHECK --interval=30s --timeout=3s \
  CMD curl -f http://localhost:8080/actuator/health || exit 1

docker-compose中配置：

yaml复制healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:8080/actuator/health"]
  interval: 30s
  timeout: 3s
  retries: 3

6.4 资源限制

限制容器资源使用：

bash复制docker run -d --name myapp \
  --memory=512m \
  --cpus=1 \
  myapp:1.0