docker部署java項(xiàng)目的詳細(xì)步驟

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

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

docker部署java項(xiàng)目步驟

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

今天我們以若依項(xiàng)目為例，總結(jié)下部署項(xiàng)目的整體流程。

簡單來說：

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

1：安裝項(xiàng)目所需中間件

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

2：將項(xiàng)目打成 jar 包

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

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

注意：

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

如下所示：

3：編寫 Dockerfile 文件，構(gòu)建鏡像

Dockerfile文件示例：

# 使用OpenJDK 17基礎(chǔ)鏡像
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

# 暴露應(yīng)用端口
EXPOSE 8008

# 添加應(yīng)用Jar包到容器中
ADD ruoyi-admin.jar ./app.jar

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

Dockerfile文件內(nèi)容釋義：

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

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 鏡像構(gòu)建時設(shè)置了三個環(huán)境變量，分別是服務(wù)端口和字符編碼相關(guān)的環(huán)境變量，LANG=C.UTF-8 和 LC_ALL=C.UTF-8：這兩個環(huán)境變量用于設(shè)置字符編碼和語言環(huán)境，\ 末尾的反斜杠 \ 是行延續(xù)符，表示下一行是當(dāng)前命令的延續(xù)

5)：EXPOSE 8008：暴露8008端口

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

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

7)：

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

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

編寫完 Dockerfile 文件后，這個時候就可以構(gòu)建鏡像了，命令：docker build -t 鏡像名稱:鏡像版本 . ，如 docker build -t ruoyi:v1.0 . 注意版本后面有個 空格點(diǎn)。使用點(diǎn) . ：表示使用當(dāng)前目錄下的 Dockerfile，如果不加這個點(diǎn)，Docker 不會知道從哪里獲取 Dockerfile。鏡像構(gòu)建完成后，可以使用 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 啟動參數(shù)
      - JAVA_OPTS="-Xmx2g -Xms2g" 
      - TZ=Asia/Shanghai
    restart: always
    network_mode: "host"

docker-compose.yml 文件內(nèi)容釋義：

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

2)：container_name：容器名稱

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

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

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

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

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

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

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;
        }
    }
}