背景

在微服務(wù)架構(gòu)的背景下，Spring Boot 已經(jīng)成為了許多項目的首選開發(fā)框架。隨著容器化技術(shù)的興起，Docker 為應(yīng)用的部署、管理提供了強(qiáng)大且靈活的方式。

本文將演示如何將一個本地開發(fā)的 Spring Boot 項目，通過 Docker 容器部署到 Linux 服務(wù)器上，并將日志文件掛載到宿主機(jī)上，以便于后期的日志管理和排查問題。

目標(biāo)

• 使用 Docker 部署 Spring Boot 項目。
• 將 日志文件掛載到宿主機(jī)，以便后期查看和管理。
• 通過 本地 IntelliJ IDEA 構(gòu)建項目，然后上傳到服務(wù)器。

1. 準(zhǔn)備工作

安裝FinalShell（遠(yuǎn)程服務(wù)器連接工具）

安裝 Docker

確保你的服務(wù)器上已經(jīng)安裝 Docker。你可以通過以下命令來檢查 Docker 是否安裝：

docker --version

如果沒有安裝 Docker，可以參考官方文檔進(jìn)行安裝

配置日志存儲路徑

在部署 Spring Boot 項目時，我們需要指定日志文件的存儲路徑。為了讓容器中的日志能夠被宿主機(jī)訪問并持久化，我們將 日志文件掛載到宿主機(jī)。

假設(shè)我們在宿主機(jī)上創(chuàng)建一個日志文件存儲目錄 /usr/app2/learn-server-app-logs：

mkdir -p /usr/app2/learn-server-app-logs
chmod -R 755 /usr/app2/learn-server-app-logs

配置 Spring Boot 日志

在你的 logback-spring.xml 配置文件中，確保日志文件輸出路徑指向容器內(nèi)的 /app/logs 路徑，并且在啟動時將該目錄掛載到宿主機(jī)：

<property name="LOG_HOME" value="log/logs" />
<appender name="FILE_LOG" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <File>${LOG_HOME}/springboot-app.log</File>
    <!-- 配置滾動策略 -->
</appender>

確保日志文件的路徑使用相對路徑（如 log/logs），Docker 會將此目錄掛載到宿主機(jī)指定的目錄。

2. 使用 IntelliJ IDEA 構(gòu)建 Spring Boot 項目

首先，我們需要將 Spring Boot 項目打包為一個可執(zhí)行的 JAR 文件。

打包 Spring Boot 項目

在 IntelliJ IDEA 中，你可以通過以下步驟來構(gòu)建項目：

打開項目，在Maven菜單欄中雙擊package進(jìn)行打包。

出現(xiàn)BUILD SUCCESS打包成功

生成的 JAR 文件

構(gòu)建完成后，你的 JAR 文件將在 target/ 目錄中，假設(shè)文件名為 learn-server.jar。

3. 創(chuàng)建 Dockerfile

為了將 Spring Boot 項目打包到 Docker 容器中，我們需要編寫一個 Dockerfile。Dockerfile 是一個簡單的腳本，它包含了構(gòu)建 Docker 鏡像所需的所有命令。

創(chuàng)建一個名為 Dockerfile 的文件：

# 選擇基礎(chǔ)鏡像
FROM openjdk:11-jre-slim
# 設(shè)置工作目錄
WORKDIR /app
# 復(fù)制構(gòu)建后的 JAR 文件到容器中
COPY learn-server.jar app.jar
# 暴露應(yīng)用程序端口
EXPOSE 10010
# 設(shè)置容器啟動時執(zhí)行的命令，啟動 Spring Boot 應(yīng)用并傳遞參數(shù)
ENTRYPOINT ["java", "-jar", "app.jar", "--server.port=10010", "--spring.profiles.active=prod"]

4.（關(guān)鍵的一步）將文件上傳到服務(wù)器

將learn-server.jar和Dockerfile文件上傳到服務(wù)器上，使用FinalShell時直接從本地磁盤將這兩個文件拖拽到/usr/app2目錄，F(xiàn)inalShell`會自動上傳。

5. 構(gòu)建 Docker 鏡像

使用下面的命令在項目目錄下構(gòu)建 Docker 鏡像：

docker build -t springboot-app .

注意：要在你上傳jar包的同級目錄下執(zhí)行

該命令將會根據(jù) Dockerfile 構(gòu)建出一個名為 springboot-app 的 Docker 鏡像。

構(gòu)建成功如圖所示：

6. 運(yùn)行 Docker 容器

使用以下命令啟動容器，并將日志文件掛載到宿主機(jī)的 /usr/app2/learn-server-app-logs 目錄：

docker run -d -p 10010:10010 --name learn-server-app -v /usr/app2/learn-server-app-logs:/app/log/logs springboot-app

• -p 10010:10010：將容器的 10010 端口映射到宿主機(jī)的 10010 端口。
• --name learn-server-app：給容器指定一個名稱。
• -v /usr/app2/learn-server-app-logs:/app/log/logs：將宿主機(jī)上的 /usr/app2/learn-server-app-logs 目錄掛載到容器中的 /app/log/logs 目錄。

使用docker logs learn-server-app查看啟動日志

啟動成功

7. 驗證部署訪問 Spring Boot 應(yīng)用

在瀏覽器中訪問 http://<服務(wù)器IP>:10010，你應(yīng)該能夠看到 Spring Boot 應(yīng)用正常啟動。

查看日志

所有生成的日志文件將被保存在宿主機(jī)上的 /usr/app2/learn-server-app-logs 目錄中，方便后期查看和管理。

tail -200f /usr/app2/learn-server-app-logs/pro-server-info.log

結(jié)論

通過 Docker 部署 Spring Boot 項目并將日志掛載到宿主機(jī)是一個非常實用的方案，尤其是在生產(chǎn)環(huán)境中。它不僅簡化了部署過程，還可以更好地管理應(yīng)用的日志。通過將日志文件存儲在宿主機(jī)上，我們可以方便地查看和管理日志，避免了容器重啟后丟失日志的風(fēng)險。

以上為個人經(jīng)驗，希望能給大家一個參考，也希望大家多多支持腳本之家。

最新評論