Java項(xiàng)目打包Docker鏡像全流程
更新時(shí)間：2025年04月10日 09:58:45 作者：魔道不誤砍柴功
本文是一份超詳細(xì)的Java項(xiàng)目Docker化實(shí)戰(zhàn)手冊,從環(huán)境準(zhǔn)備到最終上線,手把手帶你完成整個(gè)容器化部署流程,無論你是剛接觸Docker的新手,還是想系統(tǒng)梳理容器化流程的開發(fā)者,這篇文章都能給你帶來實(shí)實(shí)在在的幫助,需要的朋友可以參考下
環(huán)境準(zhǔn)備
1. 開發(fā)環(huán)境要求
- JDK 8+ (推薦JDK 11/17 LTS版本)
- Maven 3.6+ 或 Gradle 7+
- Docker Desktop (Mac/Windows) 或 Docker Engine (Linux)
- 推薦IDE: IntelliJ IDEA (社區(qū)版即可)
2. 安裝Docker
不同操作系統(tǒng)的安裝方式：
Linux (Ubuntu為例):
# 卸載舊版本
sudo apt-get remove docker docker-engine docker.io containerd runc
# 安裝依賴
sudo apt-get update
sudo apt-get install \
apt-transport-https \
ca-certificates \
curl \
gnupg \
lsb-release
# 添加Docker官方GPG密鑰
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
# 設(shè)置穩(wěn)定版?zhèn)}庫
echo \
"deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
# 安裝Docker引擎
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io
# 驗(yàn)證安裝
sudo docker run hello-world
Mac/Windows:直接下載Docker Desktop安裝包：
https://www.docker.com/products/docker-desktop
3. 驗(yàn)證安裝
docker --version # 輸出類似: Docker version 20.10.12, build e91ed57 docker-compose --version # 輸出類似: docker-compose version 1.29.2, build 5becea4c
項(xiàng)目結(jié)構(gòu)說明
我們以一個(gè)典型的Spring Boot項(xiàng)目為例：
my-java-app/ ├── src/ │ ├── main/ │ │ ├── java/com/example/demo/ │ │ │ ├── DemoApplication.java │ │ │ └── controllers/ │ │ └── resources/ │ │ ├── application.properties │ │ └── static/ │ └── test/ ├── target/ │ ├── my-java-app-0.0.1-SNAPSHOT.jar │ └── ... ├── pom.xml └── Dockerfile
Docker基礎(chǔ)概念
在開始之前，先了解幾個(gè)核心概念：
- 鏡像(Image): 只讀模板，包含運(yùn)行應(yīng)用所需的所有內(nèi)容
- 容器(Container): 鏡像的運(yùn)行實(shí)例
- Dockerfile: 構(gòu)建鏡像的指令文件
- Registry: 鏡像倉庫(如Docker Hub)
Docker的優(yōu)勢：
- 一致的運(yùn)行環(huán)境
- 快速部署和擴(kuò)展
- 資源隔離
- 易于版本管理和回滾
編寫Dockerfile
基礎(chǔ)Dockerfile示例
# 第一階段：構(gòu)建 FROM maven:3.8.4-openjdk-11 AS build WORKDIR /app COPY pom.xml . # 利用緩存下載依賴 RUN mvn dependency:go-offline COPY src ./src RUN mvn package -DskipTests # 第二階段：運(yùn)行 FROM openjdk:11-jre-slim WORKDIR /app # 從構(gòu)建階段復(fù)制jar包 COPY --from=build /app/target/my-java-app-*.jar app.jar # 暴露端口 EXPOSE 8080 # 啟動(dòng)命令 ENTRYPOINT ["java", "-jar", "app.jar"]
逐行解析
FROM maven:3.8.4-openjdk-11 AS build
使用Maven鏡像作為構(gòu)建階段的基礎(chǔ)鏡像，并命名為"build"WORKDIR /app
設(shè)置工作目錄為/appCOPY pom.xml .
復(fù)制pom.xml到工作目錄RUN mvn dependency:go-offline
下載所有依賴項(xiàng)(利用Docker緩存層)COPY src ./src
復(fù)制源代碼RUN mvn package -DskipTests
打包應(yīng)用(跳過測試)FROM openjdk:11-jre-slim
第二階段使用更小的JRE鏡像COPY --from=build /app/target/my-java-app-*.jar app.jar
從構(gòu)建階段復(fù)制生成的jar包EXPOSE 8080
聲明容器暴露的端口ENTRYPOINT ["java", "-jar", "app.jar"]
容器啟動(dòng)時(shí)執(zhí)行的命令
多階段構(gòu)建優(yōu)化
多階段構(gòu)建有三大優(yōu)勢：
- 減小鏡像體積 - 最終鏡像只包含運(yùn)行時(shí)必要內(nèi)容
- 提高安全性 - 構(gòu)建工具不會出現(xiàn)在生產(chǎn)鏡像中
- 更清晰的構(gòu)建流程 - 分離構(gòu)建和運(yùn)行環(huán)境
進(jìn)階優(yōu)化技巧
使用.dockerignore文件
避免將不必要的文件復(fù)制到鏡像中：
.git .idea *.iml target/ *.log *.tmp
選擇合適的基礎(chǔ)鏡像
openjdk:11-jdk- 完整JDK(較大)openjdk:11-jre- 僅運(yùn)行時(shí)(較小)openjdk:11-jre-slim- 更精簡版本openjdk:11-alpine- 基于Alpine Linux(最小)
層緩存優(yōu)化
將不常變化的指令放在前面，充分利用緩存：
# 先復(fù)制pom.xml并下載依賴 COPY pom.xml . RUN mvn dependency:go-offline # 然后復(fù)制源代碼 COPY src ./src
構(gòu)建與運(yùn)行鏡像
1. 構(gòu)建鏡像
# -t 指定鏡像名稱和標(biāo)簽 # . 表示使用當(dāng)前目錄的Dockerfile docker build -t my-java-app:1.0 .
構(gòu)建過程輸出示例：
[+] Building 45.3s (12/12) FINISHED => [internal] load build definition from Dockerfile 0.0s => => transferring dockerfile: 37B 0.0s => [internal] load .dockerignore 0.0s => => transferring context: 35B 0.0s => [internal] load metadata for docker.io/library/openjdk:11-jre-slim 1.5s => [internal] load metadata for docker.io/library/maven:3.8.4-openjdk-11 1.5s => [build 1/5] FROM docker.io/library/maven:3.8.4-openjdk-11@sha256:9c... 0.0s => [internal] load build context 0.1s => => transferring context: 3.01kB 0.0s => CACHED [build 2/5] WORKDIR /app 0.0s => [build 3/5] COPY pom.xml . 0.0s => [build 4/5] RUN mvn dependency:go-offline 20.1s => [build 5/5] COPY src ./src 0.0s => [build 6/5] RUN mvn package -DskipTests 18.2s => [stage-1 1/2] FROM docker.io/library/openjdk:11-jre-slim@sha256:9c... 0.0s => [stage-1 2/2] COPY --from=build /app/target/my-java-app-*.jar app.jar 0.1s => exporting to image 0.1s => => exporting layers 0.1s => => writing image sha256:7e9b6e5ba... 0.0s => => naming to docker.io/library/my-java-app:1.0 0.0s
2. 查看鏡像
docker images # 輸出示例 REPOSITORY TAG IMAGE ID CREATED SIZE my-java-app 1.0 7e9b6e5ba123 2 minutes ago 215MB
3. 運(yùn)行容器
# -d 后臺運(yùn)行 # -p 端口映射(主機(jī)端口:容器端口) # --name 容器名稱 docker run -d -p 8080:8080 --name my-app my-java-app:1.0
4. 查看運(yùn)行狀態(tài)
docker ps # 輸出示例 CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES a3b8d7e6f5g4 my-java-app:1.0 "java -jar app.jar" 2 minutes ago Up 2 minutes 0.0.0.0:8080->8080/tcp my-app
5. 查看日志
docker logs -f my-app # 輸出示例 . ____ _ __ _ _ /\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \ ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \ \\/ ___)| |_)| | | | | || (_| | ) ) ) ) ' |____| .__|_| |_|_| |_\__, | / / / / =========|_|==============|___/=/_/_/_/ :: Spring Boot :: (v2.6.3)
6. 停止和刪除容器
# 停止容器 docker stop my-app # 刪除容器 docker rm my-app # 刪除鏡像 docker rmi my-java-app:1.0
推送鏡像到倉庫
1. 登錄Docker Hub
docker login -u your-username
2. 標(biāo)記鏡像
# 格式: docker tag local-image:tagname username/repository:tagname docker tag my-java-app:1.0 your-username/my-java-app:1.0
3. 推送鏡像
docker push your-username/my-java-app:1.0
4. 從倉庫拉取運(yùn)行
docker run -d -p 8080:8080 your-username/my-java-app:1.0
生產(chǎn)環(huán)境部署
1. 使用docker-compose
創(chuàng)建docker-compose.yml文件：
version: '3.8'
services:
app:
image: your-username/my-java-app:1.0
container_name: my-java-app
ports:
- "8080:8080"
environment:
- SPRING_PROFILES_ACTIVE=prod
restart: unless-stopped
volumes:
- ./logs:/app/logs
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:8080/actuator/health"]
interval: 30s
timeout: 10s
retries: 3
啟動(dòng)服務(wù)：
docker-compose up -d
2. Kubernetes部署示例
創(chuàng)建deployment.yaml:
apiVersion: apps/v1
kind: Deployment
metadata:
name: java-app
spec:
replicas: 3
selector:
matchLabels:
app: java-app
template:
metadata:
labels:
app: java-app
spec:
containers:
- name: java-app
image: your-username/my-java-app:1.0
ports:
- containerPort: 8080
resources:
requests:
cpu: "500m"
memory: "512Mi"
limits:
cpu: "1000m"
memory: "1024Mi"
livenessProbe:
httpGet:
path: /actuator/health
port: 8080
initialDelaySeconds: 30
periodSeconds: 10
readinessProbe:
httpGet:
path: /actuator/health
port: 8080
initialDelaySeconds: 20
periodSeconds: 5
總結(jié)與最佳實(shí)踐
最佳實(shí)踐總結(jié)
鏡像優(yōu)化：
- 使用多階段構(gòu)建減小鏡像體積
- 選擇合適的基礎(chǔ)鏡像(Alpine/slim版本)
- 定期更新基礎(chǔ)鏡像以獲取安全補(bǔ)丁
構(gòu)建優(yōu)化：
- 合理利用層緩存(.dockerignore + 指令順序)
- 固定基礎(chǔ)鏡像版本(避免使用latest標(biāo)簽)
- 在CI/CD中實(shí)現(xiàn)自動(dòng)化構(gòu)建
運(yùn)行優(yōu)化：
- 限制容器資源(cpu/memory)
- 配置健康檢查
- 使用非root用戶運(yùn)行
- 正確處理信號(如SIGTERM)
安全建議：
- 不要將敏感信息硬編碼在鏡像中(使用環(huán)境變量/secret)
- 掃描鏡像中的漏洞(使用docker scan)
- 最小化容器權(quán)限(避免–privileged)
常見問題解決
Q: 構(gòu)建時(shí)下載依賴很慢怎么辦？
A: 配置Maven鏡像倉庫：
RUN mkdir -p /root/.m2 && \
echo 'aliyunhttps://maven.aliyun.com/repository/publiccentral' > /root/.m2/settings.xml
Q: 容器啟動(dòng)后立即退出？
A: 可能原因：
- 應(yīng)用啟動(dòng)失敗 - 查看日志
docker logs - 沒有前臺進(jìn)程 - 確保應(yīng)用不是以daemon方式運(yùn)行
- 端口沖突 - 檢查端口映射
Q: 如何調(diào)試容器內(nèi)的應(yīng)用？
A: 進(jìn)入運(yùn)行中的容器：
docker exec -it /bin/bash
或者直接附加到進(jìn)程：
docker attach
下一步學(xué)習(xí)建議
- 學(xué)習(xí)Docker網(wǎng)絡(luò)和存儲卷配置
- 掌握Docker Compose編排多容器應(yīng)用
- 了解Kubernetes容器編排
- 探索CI/CD流水線與Docker集成
- 學(xué)習(xí)服務(wù)網(wǎng)格(如Istio)與容器化應(yīng)用
通過本文的學(xué)習(xí)，你已經(jīng)掌握了Java項(xiàng)目容器化的核心技能。Docker的世界還有很多值得探索的地方，繼續(xù)實(shí)踐，你將發(fā)現(xiàn)更多容器化帶來的便利與效率提升！
以上就是Java項(xiàng)目打包Docker鏡像全流程的詳細(xì)內(nèi)容，更多關(guān)于Java打包Docker鏡像的資料請關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
多數(shù)據(jù)源下@transactional事務(wù)踩坑實(shí)戰(zhàn)指南
在微服務(wù)架構(gòu)日益普及的現(xiàn)在,多數(shù)據(jù)源事務(wù)管理成為常見需求,這篇文章主要介紹了多數(shù)據(jù)源下@transcation事務(wù)踩坑的相關(guān)資料,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下2026-05-05
這篇文章主要介紹了Spring Boot如何集成模板引擎FreeMarker,文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2019-10-10
SpringBoot中Zookeeper分布式鎖的原理和用法詳解
Zookeeper是一個(gè)分布式協(xié)調(diào)服務(wù)，它提供了高可用、高性能、可擴(kuò)展的分布式鎖機(jī)制，SpringBoot是一個(gè)基于Spring框架的開發(fā)框架，它提供了對Zookeeper分布式鎖的集成支持，本文將介紹SpringBoot中的 Zookeeper分布式鎖的原理和使用方法,需要的朋友可以參考下2023-07-07
這篇文章主要介紹了spring boot 結(jié)合jsp案例詳解,文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值,需要的朋友可以參考下2019-10-10
springboot如何使用thymeleaf模板訪問html頁面
springboot中推薦使用thymeleaf模板，使用html作為頁面展示。那么如何通過Controller來訪問來訪問html頁面呢？下面通過本文給大家詳細(xì)介紹，感興趣的朋友跟隨腳本之家小編一起看看吧2018-05-05
關(guān)于Java Guava ImmutableMap不可變集合源碼分析
這篇文章主要介紹Java Guava不可變集合ImmutableMap的源碼分析的相關(guān)資料,需要的朋友可以參考下面具體的文章內(nèi)容2021-09-09
這篇文章主要給大家介紹了關(guān)于Java中Getter和Setter方法及主要區(qū)別的相關(guān)資料,getter和setter方法是用于封裝類中的私有屬性的方法,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下2024-04-04
SpringBoot自定義Starter與自動(dòng)配置實(shí)現(xiàn)方法詳解
在Spring Boot官網(wǎng)為了簡化我們的開發(fā)，已經(jīng)提供了非常多場景的Starter來為我們使用，即便如此，也無法全面的滿足我們實(shí)際工作中的開發(fā)場景，這時(shí)我們就需要自定義實(shí)現(xiàn)定制化的Starter2023-02-02
對于面向?qū)ο缶幊虂碚f,抽象是它的一大特征之一,在 Java 中可以通過兩種形式來體現(xiàn)OOP的抽象:接口和抽象類,下面這篇文章主要給大家介紹了關(guān)于Java入門基礎(chǔ)之抽象類與接口的相關(guān)資料,需要的朋友可以參考下2022-04-04
本文主要介紹了Java中幾個(gè)常用的數(shù)據(jù)類型是如何輸入和輸出的，例如：Char型、int型、double型、數(shù)組、字符串等，對我們學(xué)習(xí)java有一定的幫助，感興趣的小伙伴可以跟隨小編一起學(xué)習(xí)學(xué)習(xí)2021-12-12