docker部署java項目的詳細步驟

更新時間：2025年03月21日 10:04:15 作者：java阿杜

這篇文章主要介紹了docker部署java項目的詳細步驟,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教

docker部署java項目步驟

在平常的開發(fā)工作中，我們經常需要部署項目，開發(fā)測試完成后，最關鍵的一步就是部署。

今天我們以若依項目為例，總結下部署項目的整體流程。

簡單來說：

第一步：安裝項目所需的中間件；
第二步：將項目打包成 jar 包；
第三步：編寫 Dockerfile 文件，構建鏡像；
第四步：編寫 docker-compose.yml 文件；
第五步：編寫 nginx.conf 文件；
第六步：啟動項目，進行測試；

1：安裝項目所需中間件

項目部署依賴的中間件，如數據庫 mysql 、緩存 redis、負載均衡 nginx 等，這些中間件的安裝就不在這兒一一贅述了。如果有不清楚的小伙伴，可以看我之前寫的幾篇文章，如下：

2：將項目打成 jar 包

部署不同的環(huán)境，需要選擇不同的配置文件，部署測試環(huán)境一般選擇 application-test.yml 文件打包，部署生產環(huán)境一般選擇 application-prod.yml 文件。

打 jar 包時一定注意本地修改不需要提交的配置，先回滾，然后拉取最新的代碼，點擊 maven clean，然后點擊 package 打包，打包完后在 target 目錄。將 jar 包上傳到服務器指定的目錄。

注意：

比如在服務器上新建一個 /docker/ruoyi/ 的目錄，那么 jar 包放在這個目錄下，在這個目錄下再新建 Dockerfile 文件和 docker-compose.yml 文件

如下所示：

3：編寫 Dockerfile 文件，構建鏡像

Dockerfile文件示例：

# 使用OpenJDK 17基礎鏡像
FROM openjdk:17
# 創(chuàng)建一個名為/ruoyi/logs的目錄
RUN mkdir -p /ruoyi/logs
# 切換工作目錄
WORKDIR /ruoyi
# 配置環(huán)境變量
ENV SERVER_PORT=8008 \
    LANG=C.UTF-8 \
    LC_ALL=C.UTF-8

# 暴露應用端口
EXPOSE 8008

# 添加應用Jar包到容器中
ADD ruoyi-admin.jar ./app.jar

# 設置啟動命令
ENTRYPOINT ["java", \
           "-Dserver.port=${SERVER_PORT}", \
           "-Xlog:gc*:time,tags,level", \
           "-XX:+UseZGC", \
           "-jar", "app.jar"]

Dockerfile文件內容釋義：

1)：FROM openjdk:17：使用OpenJDK 17基礎鏡像

2)：RUN mkdir -p /ruoyi/logs：創(chuàng)建一個名為/ruoyi/logs的目錄，即日志目錄

3)：WORKDIR /ruoyi：切換工作目錄

4)：ENV SERVER_PORT=8008 \

LANG=C.UTF-8 \
LC_ALL=C.UTF-8

配置環(huán)境變量，Docker 鏡像構建時設置了三個環(huán)境變量，分別是服務端口和字符編碼相關的環(huán)境變量，LANG=C.UTF-8 和 LC_ALL=C.UTF-8：這兩個環(huán)境變量用于設置字符編碼和語言環(huán)境，\ 末尾的反斜杠 \ 是行延續(xù)符，表示下一行是當前命令的延續(xù)

5)：EXPOSE 8008：暴露8008端口

6)：ADD ruoyi-admin.jar ./app.jar：

添加應用Jar包到容器中，ADD：這是 Dockerfile 里用于復制文件和目錄的指令，ruoyi-admin.jar：這是位于宿主機上的源文件路徑，./app.jar：這是目標路徑，指定將源文件復制到 Docker 鏡像中的位置和文件名。./ 表示鏡像中的當前 # 工作目錄，將源文件 ruoyi-admin.jar 復制到鏡像的當前工作目錄下，并命名為 app.jar

7)：

ENTRYPOINT ["java", \
"-Dserver.port=${SERVER_PORT}", \
"-Xlog:gc*:time,tags,level", \
"-XX:+UseZGC", \
"-jar", "app.jar"]

a：ENTRYPOINT 關鍵字：這是 Dockerfile 里用來定義容器啟動命令的指令。
b："java"：表明要執(zhí)行的是 Java 虛擬機。
c："-Dserver.port=${SERVER_PORT}"：設置 Java 虛擬機的系統(tǒng)屬性。server.port 通常用于指定 Spring Boot 應用程序監(jiān)聽的端口，#${SERVER_PORT} 是一個環(huán)境變量引用，其值在之前的 ENV 指令中設置為 8008，這意味著應用程序會監(jiān)聽 8008 端口。
d："-Xlog:gc*:time,tags,level"：開啟 Java 垃圾回收（GC）日志記錄功能。gc* 表示記錄所有與垃圾回# 收相關的事件，time,tags,level 表示日志中要包含時間、事件標簽和日志級別等信息。
e："-XX:+UseZGC"：啟用 Z Garbage Collector（ZGC），這是 Java 11 及以上版本引入的一種可擴展的低# 延遲垃圾回收器，能顯著減少垃圾回收停頓時間。
f："-jar"：告訴 Java 虛擬機要執(zhí)行一個 JAR 包，"app.jar"：指定要執(zhí)行的 JAR 包名稱，這個 JAR 包是之前使用 ADD 或 COPY 指令復制到鏡像中的。

編寫完 Dockerfile 文件后，這個時候就可以構建鏡像了，命令：docker build -t 鏡像名稱:鏡像版本 . ，如 docker build -t ruoyi:v1.0 . 注意版本后面有個 空格點。使用點 . ：表示使用當前目錄下的 Dockerfile，如果不加這個點，Docker 不會知道從哪里獲取 Dockerfile。鏡像構建完成后，可以使用 docker images 查看生成的鏡像：

4：編寫 docker-compose.yml 文件

docker-compose.yml 文件示例：

services:
  ruoyi-admin:
    image: ruoyi-admin:v1.0
    container_name : ruoyi-admin
    environment:
      - SERVER_PORT=8008
	  # 可選，Java 啟動參數
      - JAVA_OPTS="-Xmx2g -Xms2g" 
      - TZ=Asia/Shanghai
    restart: always
    network_mode: "host"

docker-compose.yml 文件內容釋義：

1)：image: ruoyi-admin:v1.0：服務會使用ruoyi-admin:v1.0鏡像來創(chuàng)建容器

2)：container_name：容器名稱

3)：SERVER_PORT=8008：定義環(huán)境變量

4)：- JAVA_OPTS="-Xmx2g -Xms2g"：可選參數，-Xmx用來設定 JVM 堆內存的最大使用量；-Xms用于設置 JVM 堆內存的初始使用量。JAVA_OPTS="-Xmx2g -Xms2g" 把 JVM 堆內存的初始大小和最大大小都設置為 2GB。這么做可以避免在應用程序運行過程中頻繁進行堆內存的擴容和縮容操作，從而提升性能。不過，設置時要依據應用程序的實際內存需求和服務器的可用內存來合理調整，防止出現內存不足或者浪費的情況。

5)：- TZ=Asia/Shanghai：把容器內的時區(qū)指定為 Asia/Shanghai（即上海所在的時區(qū)，也就是中國標準時間，UTC+8）。這樣容器內運行的應用程序所顯示和處理的時間會UTC+8時區(qū)處理。

6)：restart: always：為容器指定了一種重啟策略，確保容器在各種情況下都能盡可能保持運行狀態(tài)。當容器由于各種原因（如正常退出、異常崩潰、宿主機重啟等）停止運行時，Docker 會依據此策略自動嘗試重啟容器。除了always，還有其他幾種重啟策略：

no：默認策略，容器停止后不會自動重啟。
on-failure：只有當容器以非零退出碼退出時，Docker 才會嘗試重啟它?？梢酝ㄟ^ on-failure: N 的形式指定最多重啟 N 次。
unless-stopped：容器停止后，除非手動停止（如使用 docker stop 命令），否則 Docker 會在 Docker 守護進程重啟或宿主機重啟后自動重啟容器。

7)：network_mode: "host"：指定容器使用宿主機的網絡，即容器直接使用宿主機的網絡接口，而非創(chuàng)建獨立的 Docker 網絡。

5：配置 nginx.conf

nginx.conf 文件示例：

user  nginx;
worker_processes  auto;

pid        /var/run/nginx.pid;

events {
    worker_connections  1024;
}

http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;

    sendfile        on;

    keepalive_timeout  60;

	server {
        listen 80;
        server_name localhost;
        
	    charset utf-8;

        location / {
           proxy_pass  http://localhost:8008;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        }
    }
}