簡介這是一份面向 Java 后端開發(fā)者與運維初學者的 Docker 部署實踐文檔圍繞在 Windows 環(huán)境中將 SpringBoot 項目構建為鏡像并遷移到 Linux 主機運行展開。內容從 Dockerfile 基礎寫法切入串聯(lián) jar 包復制、端口暴露、鏡像構建、容器啟動與日志查看并延伸到容器網絡連通性測試、宿主機或獨立 MySQL 容器訪問、數(shù)據(jù)庫掛載目錄持久化等常見問題。文檔還涉及共享主機網絡、ping 與 telnet 排查、Docker Compose 管理多容器應用等排錯思路對鏡像命名、端口沖突、容器重啟策略、MySQL 初始化密碼與目錄映射等細節(jié)也有交代幫助讀者理解鏡像、容器與數(shù)據(jù)卷之間的關系形成從本地開發(fā)機到 Linux 部署環(huán)境的完整參考。文件包共 1 個 docx約 2.48MB以圖文說明和命令示例為主便于對照實踐。已有 135 人學習適合作為 SpringBoot 容器化入門與跨平臺部署的實操資料。1. Windows 里把鏡像跑起來只是前半場搬到 Linux 才是真正的驗收在 Windows 上把 SpringBoot 項目打成 Docker 鏡像、docker run起容器、瀏覽器打開 8080 看到首頁很多人到這一步就收工了等docker save出一個幾百兆的 tar 丟到 Linux 上docker load起來容器啟動幾秒就退出日志里一行Connection refused指向數(shù)據(jù)庫才發(fā)現(xiàn)這套環(huán)境從來不是“裝個 Docker”這么簡單。Dockerfile 里 jar 路徑寫錯容器網絡默認橋接解析不了容器名MySQL 數(shù)據(jù)目錄掛載權限對不上Linux 上的 docker-ce 版本比鏡像還老任何一處都能讓頁面白屏。這套流程適合手上有 SpringBoot MySQL Redis、想在 Windows 上開發(fā)調試、再把同一份鏡像搬到 Linux 跑起來的人。下面按裝什么、怎么裝、壞了怎么救走一遍。2. Dockerfile 落地openjdk:8-jdk-alpine 五行寫死一個可移植鏡像鏡像能不能在另一臺機器上活著跑起來八成取決于 Dockerfile 里那幾個路徑和基礎鏡像選得對不對。這一章先把項目結構釘死再逐行拆一份能直接抄的 Dockerfile最后把docker build和docker run兩刀砍下去。2.1 先把 jar 包位置和 Dockerfile 擺放位置固定下來SpringBoot 項目打包用 Maven 就是一條命令產出的 jar 默認落在target目錄下名字帶版本號。真正容易翻車的是位置Dockerfile必須放在項目根目錄也就是pom.xml同級因為它決定了docker build的構建上下文build contextCOPY后面的源路徑永遠是相對這個上下文算的不是相對Dockerfile所在行的位置。springboot-demo/ ├── pom.xml ├── Dockerfile - 必須在這一層 ├── src/ │ └── main/java/... └── target/ └── demo-app-1.0.0.jar - mvn package 之后才有打包命令用跳過測試的那條本地驗證過功能再跳別在 CI 里也一路跳過# 清理舊產物并跳過測試打包產物落在 target/ 下 mvn clean package -DskipTests打包完先ls target/*.jar看一眼真實文件名。target目錄里經常還有xxx.jar.original這種后綴COPY target/*.jar app.jar在某些情況下會匹配到多個文件直接報錯所以我在正式 Dockerfile 里一律寫死完整文件名寧可改一次 Dockerfile 也不留這個隱患。如果你的項目名和版本號經常變那就退一步用COPY target/*.jar前先確認target下只有一個 jar或者加.dockerignore把*.original排除掉。2.2 逐行拆 DockerfileFROM、WORKDIR、COPY、EXPOSE、ENTRYPOINT這是能直接用的版本比原始寫法多了一個時區(qū)參數(shù)原因后面講# 基礎鏡像用 OpenJDK 8 的 alpine 精簡版體積小夠跑 SpringBoot FROM openjdk:8-jdk-alpine # 容器內的工作目錄后面的相對路徑都基于它 WORKDIR /app # 把本地構建出的 jar 復制進鏡像并重命名為固定的 app.jar COPY target/demo-app-1.0.0.jar app.jar # 聲明應用監(jiān)聽 8080屬于元數(shù)據(jù)不做端口映射 EXPOSE 8080 # 啟動命令exec 形式PID 1 就是 java 進程 ENTRYPOINT [java, -Duser.timezoneAsia/Shanghai, -jar, /app/app.jar]FROM選openjdk:8-jdk-alpine的理由很實際SpringBoot 2.x 配 JDK 8 是主流組合alpine 版本鏡像只有百來兆推來推去不心疼。要注意 alpine 里沒有 glibc項目如果依賴 netty-tcnative 或者某些本地庫運行時會報Error loading shared library這種項目就得換openjdk:8-jdk-slim這類基于 Debian 的鏡像。WORKDIR /app不只是切目錄它會在鏡像層里創(chuàng)建這個目錄后面的COPY和ENTRYPOINT里寫/app/app.jar才對得上。COPY的兩個參數(shù)順序是“源 目標”源必須在構建上下文里../target/xxx.jar這種寫法直接失敗因為上下文之外的文件 Docker 看不見。EXPOSE 8080只是聲明不 publish真正對外還得靠docker run -p。寫它的價值在于別人docker inspect鏡像時能看到這個服務該用哪個端口。ENTRYPOINT用 JSON 數(shù)組的 exec 形式不是ENTRYPOINT java -jar app.jar這種 shell 形式。區(qū)別很致命shell 形式下 PID 1 是/bin/sh -cjava 進程是子進程docker stop發(fā)的 SIGTERM 到不了 JVM容器只能等 10 秒超時后被 SIGKILL 強殺SpringBoot 的優(yōu)雅停機、連接池關閉全都不執(zhí)行。這個坑在開發(fā)環(huán)境看不出來上了 Linux 跑久了才會發(fā)現(xiàn)每次重啟都丟在途請求。時區(qū)參數(shù)-Duser.timezoneAsia/Shanghai是我必加的。alpine 鏡像默認 UTC容器里new Date()出來的時間比北京時間少 8 小時日志時間戳全是錯的排查問題時能把人繞暈。alpine 里沒裝 tzdata所以配TZ環(huán)境變量沒用直接給 JVM 傳時區(qū)最省事。2.3 docker build 后面那個點以及鏡像命名和緩存構建命令在 PowerShell 里執(zhí)行先cd到含Dockerfile的項目根目錄# -t 指定鏡像名和標簽最后那個點代表當前目錄作為構建上下文 docker build -t demo-app:1.0.0 .那個.是最容易被忽略又最容易出事的地方。它把當前目錄整個打包發(fā)給 Docker daemontarget里幾百兆的 jar、.git目錄、node_modules都會被送進去構建慢得像卡住。常見做法是在項目根目錄放一個.dockerignore.git .idea *.iml target/*.original logs/注意別把target/整個排除掉jar 就在里面COPY會直接失敗。-t demo-app:1.0.0的命名建議固定成“項目名:版本號”后面在 Linux 上docker save、docker load、docker run全程用這個名字版本號跟著pom.xml走。見過有人用docker build -t app .結果本地攢了七八個同名不同內容的app:latest出問題時根本分不清跑的是哪個包這就是自找的。緩存問題也得提一句。COPY target/xxx.jar app.jar這一行只要 jar 內容變了緩存就失效后面的層全部重建這是正常的。但如果改完代碼忘了mvn packageCOPY拿到的還是舊 jar構建依然“成功”容器里的代碼卻是老的排查半天以為是環(huán)境問題。我一般把打包和構建串成一條命令mvn clean package -DskipTests; if ($?) { docker build -t demo-app:1.0.0 . }if ($?)是 PowerShell 里判斷上一條命令是否成功打包失敗就不構建省得拿著舊包騙自己。2.4 起容器、看日志、確認端口映射# -d 后臺運行-p 宿主機端口:容器端口--name 給容器起個固定名字 docker run -d -p 8080:8080 --name demo-app demo-app:1.0.0 # 看容器是否還活著STATUS 里出現(xiàn) Up 才算數(shù) docker ps # 跟蹤日志出問題第一眼看這里 docker logs -f demo-app-p 8080:8080左邊是 Windows 宿主機端口右邊是容器內端口右邊必須和 Dockerfile 里EXPOSE以及 SpringBoot 的server.port一致。左邊被占用是最常見的啟動失敗原因比如本機已經跑了一個 Tomcat 或者另一個 SpringBootdocker run會直接報port is already allocated改左邊的端口就行比如-p 8081:8080。docker logs是這套環(huán)境的黑匣子。SpringBoot 啟動失敗都會在日志里留下痕跡UnknownHostException指向數(shù)據(jù)庫地址解析不了Access denied for user指向賬號密碼或授權范圍不對Communications link failure指向網絡不通。容器剛起來就退出的時候docker ps看不到它得用docker ps -a找再docker logs看退出原因。瀏覽器訪問http://localhost:8080能出頁面說明 Dockerfile、構建、端口映射這三段路是通的。但頁面能出來不代表業(yè)務能跑只要涉及數(shù)據(jù)庫查詢下一步就得處理容器怎么連到 MySQL。3. 容器網絡與中間件dev_net、MySQL 8.0.24 和 Redis 怎么串起來Windows 上跑容器訪問本機數(shù)據(jù)庫是這套流程里最容易“看起來通了其實沒通”的一段。原文里試過--nethost也試過先 ping 再改配置我把順序重新理一遍順手把 MySQL 和 Redis 也容器化。3.1 默認 bridge 解析不了容器名dev_net 才行Docker 容器默認掛在bridge網絡上這個默認網絡只有 IP 轉發(fā)沒有內嵌 DNS容器之間用容器名互相訪問會直接報UnknownHostException。自己docker network create出來的用戶自定義網絡才帶 DNS 解析容器名可以直接當主機名用。# 創(chuàng)建一個自定義橋接網絡后面的應用、MySQL、Redis 都接進來 docker network create dev_net # 看網絡列表確認 dev_net 在里面 docker network ls接入用docker network connect容器跑起來之后也能接不用重建docker network connect dev_net mysqldoc docker network connect dev_net redis docker network connect dev_net demo-app應用容器這一步經常被漏掉。MySQL 和 Redis 都連上dev_net了應用還在默認bridge上照樣解析不了mysqldoc。三條connect一條都不能少接了之后用docker inspect驗一下# 只取容器在 dev_net 里的 IP有輸出說明接上了 docker inspect -f {{range $k, $v : .NetworkSettings.Networks}}{{$k}} {{$v.IPAddress}}{{end}} demo-app3.2 從容器里 ping 和 telnet 3306先判斷再改配置連不上數(shù)據(jù)庫時別急著改 yml先在容器里做兩步診斷。原始做法是從應用容器 ping 數(shù)據(jù)庫容器或 IP再 telnet 3306 端口。# 容器內 ping 數(shù)據(jù)庫容器名驗證 DNS 解析和二層連通 docker exec -it demo-app ping mysqldoc # 容器內 telnet 數(shù)據(jù)庫端口驗證 TCP 層通不通 docker exec -it demo-app telnet mysqldoc 3306這里有個現(xiàn)實問題openjdk:8-jdk-alpine鏡像里既沒有ping也沒有telnet直接執(zhí)行會報not found。常見做法是臨時進容器裝一個 busybox 擴展或者反過來從 MySQL 容器往應用容器 ping因為mysql:8.0.24鏡像里通常有ping。更省事的做法是# 用自帶 bash 的容器做網絡探測把它接到同一個網絡里 docker run --rm --net dev_net busybox ping -c 2 mysqldoc--rm表示跑完即刪不留垃圾容器--net dev_net讓它和業(yè)務容器在同一個網絡里這樣測出來的結果才有參考價值。ping 通只說明網絡層沒問題3306 還得單獨驗端口沒監(jiān)聽或者 MySQL 沒起來ping 是通但 telnet 不通的。3.3 MySQL 8.0.24 容器化四個掛載目錄和 3307 端口Windows 上先建掛載目錄PowerShell 里一條mkdir可以帶多個路徑mkdir D:\development_sources\docker\mysql\log,D:\development_sources\docker\mysql\data,D:\development_sources\docker\mysql\conf,D:\development_sources\docker\mysql\mysql-files然后跑容器參數(shù)一個一個擺開docker run -p 3307:3306 --restartalways --name mysqldoc -v D:\development_sources\docker\mysql\log:/var/log/mysql -v D:\development_sources\docker\mysql\data:/var/lib/mysql -v D:\development_sources\docker\mysql\conf:/etc/mysql -v D:\development_sources\docker\mysql\mysql-files:/var/lib/mysql-files -e MYSQL_ROOT_PASSWORDroot -d mysql:8.0.24PowerShell 里的續(xù)行符是反引號別抄成 Linux 的反斜杠\抄錯了命令會被拆成幾條執(zhí)行報一堆莫名其妙的錯。參數(shù)作用取舍說明-p 3307:3306宿主機 3307 映射容器 3306本機已有 MySQL 占了 3306開發(fā)機這樣錯開最省事--restartalways容器異常退出或 Docker 重啟后自動拉起開發(fā)機也建議加省得每次開機手動 start--name mysqldoc固定容器名后面容器名要寫進 yml名字不能亂改-v .../log:/var/log/mysql日志落宿主機出問題直接在 Windows 上看日志文件-v .../data:/var/lib/mysql數(shù)據(jù)文件落宿主機容器刪了數(shù)據(jù)還在這條是命根子-v .../conf:/etc/mysql配置文件掛進去想改my.cnf不用進容器-v .../mysql-files:/var/lib/mysql-files導入導出目錄LOAD DATA之類操作要用-e MYSQL_ROOT_PASSWORDrootroot 初始密碼只在數(shù)據(jù)目錄為空、首次初始化時生效最后一條特別容易誤解MYSQL_ROOT_PASSWORD只在/var/lib/mysql為空、容器執(zhí)行初始化時讀取。掛載目錄里已經有數(shù)據(jù)了改這個環(huán)境變量密碼不會變得進容器用ALTER USER改。容器起來后用數(shù)據(jù)庫客戶端連127.0.0.1:3307驗證注意端口是 3307 不是 3306。業(yè)務賬號別直接用 root在容器里建一個限定來源的賬號# 進入容器內的 mysql 客戶端 docker exec -it mysqldoc mysql -uroot -p-- 應用賬號只允許從任意容器來源連接密碼自己換掉 CREATE USER app_user% IDENTIFIED BY App123456; GRANT ALL PRIVILEGES ON app_db.* TO app_user%; FLUSH PRIVILEGES; -- 如果只允許某個固定 IP 來源把 % 換成具體地址 -- CREATE USER app_user192.168.0.27 IDENTIFIED BY App123456;MySQL 8 的默認認證插件是caching_sha2_password老的 JDBC 驅動連它會報Public Key Retrieval is not allowed所以后面 JDBC URL 里要帶allowPublicKeyRetrievaltrue或者把賬號改成mysql_native_password。這兩條路選一條別兩邊都改完再互相干擾。3.4 Redis 容器6380 端口、AOF 和密碼Redis 的部署結構簡單得多一個數(shù)據(jù)目錄就夠mkdir D:\development_sources\docker\redis\data docker run -p 6380:6379 --restartalways --name redis -v D:\development_sources\docker\redis\data:/data -d redis redis-server --appendonly yes --requirepass redis-p 6380:6379同樣是為了避開宿主機已經占用的 6379。--appendonly yes打開 AOF 持久化每條寫命令追加到文件容器重啟后數(shù)據(jù)能重建不打開的話重啟即清空開發(fā)環(huán)境丟點緩存無所謂但如果拿 Redis 存了業(yè)務狀態(tài)就會出事。--requirepass redis設密碼最后這幾個參數(shù)是傳給redis-server的命令行參數(shù)順序必須在鏡像名之后寫到鏡像名前面會被 Docker 當成自己的參數(shù)而報錯。容器起來后docker network connect dev_net redis接進同一個網絡再用 Redis 桌面客戶端連127.0.0.1:6380密碼填redis能PING出PONG就算通了。3.5 yml 里寫容器名還是 IP以及 --nethost 在 Windows 上的局限網絡通了之后改 SpringBoot 的配置文件host直接寫容器名spring: datasource: url: jdbc:mysql://mysqldoc:3306/app_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: app_user password: App123456 redis: host: redis port: 6379 password: redis兩個端口別寫錯容器內 MySQL 永遠是 3306Redis 永遠是 63793307和6380只是宿主機映射出去給 Windows 上的客戶端用的。在 yml 里寫成 3307容器之間是連不上的這個錯我見過不止一次。serverTimezoneAsia/Shanghai和前面 JVM 的時區(qū)參數(shù)是一套的兩邊都不寫插入的時間字段就會差 8 小時。useSSLfalse在開發(fā)環(huán)境關掉省事生產環(huán)境該開還得開。至于--nethost原文試過之后評價“意義不大”我補一下原因Windows 上的 Docker Desktop 跑在一層輕量虛擬機里--nethost共享的是那臺虛擬機的網絡棧不是 Windows 宿主機本身所以想靠它連 Windows 上的 MySQL大概率還是不通。Linux 上--nethost是真共享宿主機網絡行為完全不同?？缙脚_部署時這個差異足夠讓人懷疑人生所以我的做法是統(tǒng)一走dev_net加容器名Windows 和 Linux 行為一致遷移的時候不用改配置。4. 避坑與排查容器起不來、連不上庫的五個現(xiàn)場下面五條都是我自己踩過或者幫別人收拾過的現(xiàn)場按“現(xiàn)象 → 原因 → 解決”記。4.1 構建和啟動階段的三條第一條容器啟動幾秒就 Exiteddocker ps里看不到?，F(xiàn)象docker run回車后返回一串容器 IDdocker ps空空如也docker ps -a能看到狀態(tài)是Exited (1)。原因九成是 jar 路徑不對或者 jar 本身沒打出來。COPY在構建階段就會失敗但如果是ENTRYPOINT里的路徑寫錯構建能過運行時 java 找不到 jar 直接退出。解決先docker logs 容器名看最后幾行典型報錯是Error: Unable to access jarfile /app/app.jar?；氐巾椖坷飈s target/*.jar確認文件名再核對COPY的目標名和ENTRYPOINT里的是否一致順便確認mvn package真的執(zhí)行過別拿著空target目錄構建。第二條改了代碼鏡像重建了容器里跑的還是老邏輯?，F(xiàn)象接口返回的字段和本地代碼對不上日志里的時間戳也停在幾小時前。原因docker build用了緩存或者更常見的是打包那步漏了COPY復制進去的就是舊 jar。Docker 只按文件內容算哈希內容沒變就復用緩存層它不會知道你改的是src里的 java 文件。解決養(yǎng)成mvn clean package再docker build的固定順序懷疑緩存問題時加--no-cachedocker build --no-cache -t demo-app:1.0.0 .--no-cache會把所有層重建慢但干凈。另外docker run前先docker rm -f demo-app刪舊容器不然--name沖突會直接報錯有人以為報錯就是構建失敗其實只是名字被占了。第三條docker run報端口已被占用?，F(xiàn)象Bind for 0.0.0.0:8080 failed: port is already allocated。原因宿主機 8080 已經被別的進程或容器占著Windows 上常見的是另一份 SpringBoot 在 IDEA 里跑著沒關或者上次的容器沒刪干凈。解決netstat -ano | findstr :8080找到占用進程該關的關掉不想關就換映射端口-p 8081:8080容器內還是 8080對外訪問改成 8081 即可。別去改 Dockerfile 里的EXPOSE那是元數(shù)據(jù)改了也解決不了沖突。4.2 連庫和遷移階段的兩條第四條容器里訪問數(shù)據(jù)庫報UnknownHostException: mysqldoc?，F(xiàn)象應用啟動日志里拋java.net.UnknownHostException或者Communications link failure但用數(shù)據(jù)庫客戶端從 Windows 連127.0.0.1:3307是好的。原因應用容器和 MySQL 容器不在同一個用戶自定義網絡上默認bridge沒有 DNS 解析容器名根本不是一個能解析的主機名。解決確認三方都接進了dev_netdocker network inspect dev_net看Containers里是不是三個容器都在。少哪個就docker network connect dev_net 名字補上然后重啟應用容器讓 SpringBoot 重新解析。還有一種情況是 yml 里寫了容器的 IP容器重建后 IP 變了所以寫容器名、不寫 IP。第五條數(shù)據(jù)庫容器升級或者換機器后數(shù)據(jù)“沒了”?，F(xiàn)象在 Windows 上跑得好好的庫換到 Linux 上重新docker run之后表全空只剩一個空庫。原因-v掛的是宿主機目錄換機器等于換了一個空目錄MySQL 發(fā)現(xiàn)/var/lib/mysql為空就重新初始化。容器本身不會隨鏡像帶走數(shù)據(jù)這點和鏡像完全兩回事。解決遷移前先mysqldump導出 SQL在新機器上起容器、建庫、導數(shù)據(jù)不要指望把 Windows 的數(shù)據(jù)目錄直接拷到 Linux 上能用——目錄里的文件屬主是容器內的 mysql 用戶uid 通常是 999Linux 上權限對不上容器會起不來日志里一堆Permission denied。如果非要拷目錄得在新機器上chown -R 999:999對齊 uid還得處理 SELinux 上下文不如導出導入干凈。5. 遷移到 Linuxdocker save 打包 CentOS 7 裝 docker-ce-18.03.1.ceWindows 那邊驗證通過了接下來的活是把鏡像搬到 Linux。核心就三件事docker save出 tar、目標機裝 Docker、docker load回來重跑。5.1 docker save 三個 tar應用、MySQL、Redis鏡像必須一個一個存docker save一條命令只打包一個鏡像新版本可以帶多個鏡像名但老版本不行別賭# -o 指定輸出文件后面跟鏡像名:標簽 docker save -o demo-app.tar demo-app:1.0.0 docker save -o mysqlimage.tar mysql:8.0.24 docker save -o myredisimage.tar redis三個 tar 都要存因為 Linux 上的 Docker 不保證能拉到完全一樣的鏡像尤其是沒有外網或者鏡像站抽風的時候。文件大小心里要有數(shù)MySQL 8.0.24 的鏡像 tar 通常幾百兆應用鏡像看依賴幾十兆到幾百兆。三個加起來超過 1G 很正常傳輸前先看目標盤的剩余空間。鏡像名和標簽要和 Linux 上docker run用的完全一致save的時候寫mysql:8.0.24load回來就還是mysql:8.0.24寫mysql不帶標簽load 回來就是mysql:latest后面啟動腳本里的標簽對不上容器起不來。這個細節(jié)我吃過虧現(xiàn)在 save 之前都先docker images抄一遍完整名字。還有一個跨架構的注意點Windows 上的 Docker Desktop 默認拉的是linux/amd64架構的鏡像和 x86_64 的 CentOS 7 一致正常不會出問題。如果構建機是 ARM 架構就得在docker build時顯式指定--platform linux/amd64否則 load 到 Linux 上會報no matching manifest或者容器起來直接exec format error。5.2 CentOS 7 上裝 docker-ce-18.03.1.ce源、依賴、啟動Linux 側先確認版本內核 3.10 的 CentOS 7 是這套組合里最常見的底子uname -r # 3.10.0-1062.56.1.el7.x86_64遠程連接工具隨便挑一個順手的 SSH 客戶端輸入 IP、端口、賬號密碼連上命令行和文件管理都在一個界面里后面?zhèn)?tar 包方便。開發(fā)環(huán)境為了省事經常直接關防火墻生產環(huán)境千萬別這么干# 關閉防火墻并禁用開機自啟僅限內網開發(fā)環(huán)境 systemctl stop firewalld systemctl disable firewalld裝 Docker 之前先把舊版本清干凈CentOS 7 上有些老包會互相干擾# 卸載可能存在的舊版本沒裝過會提示 nothing to do正常 yum remove docker docker-common docker-selinux docker-engine # yum-utils 提供 yum-config-manager另外兩個是存儲驅動依賴 yum install -y yum-utils device-mapper-persistent-data lvm2 # 添加 docker-ce 的 yum 源地址換成你環(huán)境能訪問的鏡像站 yum-config-manager --add-repo http://你的鏡像站地址/docker-ce/linux/centos/docker-ce.repo # 列出可安裝版本從高到低排序 yum list docker-ce --showduplicates | sort -r # 安裝指定版本這是我們這套環(huán)境驗證過的版本 yum -y install docker-ce-18.03.1.ce版本這里要留意 yum 包名的完整形式實際的包名通常是docker-ce-18.03.1.ce-1.el7.centosyum install docker-ce-18.03.1.ce能匹配到就可以匹配不到就用yum list輸出里的全名。18.03 這個版本比較老好處是和舊內核、舊鏡像兼容性好壞處是有些新鏡像的 manifest 格式它不認。如果docker load時報格式相關的錯不要硬扛記下報錯信息確認鏡像能在更新的 Docker 上 load 成功再決定要不要升版本。裝完啟動并設開機自啟systemctl start docker systemctl enable docker # 確認版本Client 和 Server 兩段都要有輸出 docker versionCentOS 7 上默認存儲驅動可能是devicemapper性能和穩(wěn)定性都不如overlay2。內核 3.10 是支持 overlay2 的建議顯式寫進配置{ storage-driver: overlay2, log-driver: json-file, log-opts: { max-size: 100m, max-file: 3 } }把這段寫進/etc/docker/daemon.json然后systemctl restart docker。日志限制那兩行是后悔藥不加的話容器日志會把磁盤寫滿等到no space left on device的時候服務已經掛了。改完存儲驅動如果起不來先docker info | grep -i storage看實際生效的驅動必要時把/var/lib/docker清空重來——前提是沒有重要鏡像所以這一步要在 load 之前做。5.3 上傳 tar 包、load 鏡像、按 Linux 的路徑重跑容器用 SSH 客戶端的文件管理把三個 tar 傳到 Linux 的自定義目錄比如/opt/loadimages然后逐個加載cd /opt/loadimages # -i 指定輸入文件執(zhí)行完 docker images 能看到鏡像 docker load -i demo-app.tar docker load -i mysqlimage.tar docker load -i myredisimage.tar # 確認三個鏡像都在標簽對得上 docker imagesdocker load可能輸出Loaded image: demo-app:1.0.0也可能只輸出層 ID 的進度最后以docker images的結果為準。容器要按 Linux 的路徑重跑不能照抄 Windows 的D:\...。先建目錄mkdir -p /data/docker/mysql/{log,data,conf,mysql-files} mkdir -p /data/docker/redis/dataMySQL 和 Redis 的啟動命令除了掛載路徑其余參數(shù)和 Windows 上保持一致docker network create dev_net docker run -p 3307:3306 --restartalways --name mysqldoc \ -v /data/docker/mysql/log:/var/log/mysql \ -v /data/docker/mysql/data:/var/lib/mysql \ -v /data/docker/mysql/conf:/etc/mysql \ -v /data/docker/mysql/mysql-files:/var/lib/mysql-files \ -e MYSQL_ROOT_PASSWORDroot \ -d mysql:8.0.24 docker run -p 6380:6379 --restartalways --name redis \ -v /data/docker/redis/data:/data \ -d redis redis-server --appendonly yes --requirepass redis docker run -d -p 8080:8080 --name demo-app demo-app:1.0.0 docker network connect dev_net mysqldoc docker network connect dev_net redis docker network connect dev_net demo-app順序上先把中間件起好再起應用不然應用啟動時連不上數(shù)據(jù)庫SpringBoot 可能直接啟動失敗。數(shù)據(jù)從 Windows 遷過來的話用mysqldump導出的 SQL 在新容器里source一遍別直接拷數(shù)據(jù)目錄。5.4 SELinux 和目錄權限CentOS 上特有的兩個坑CentOS 7 默認開著 SELinux-v掛載宿主機目錄時容器進程可能沒有寫權限表現(xiàn)是 MySQL 容器啟動失敗日志里Cant create/write to file或者Permission denied。開發(fā)環(huán)境圖省事可以臨時關掉# 查看當前狀態(tài)Enforcing 表示開著 getenforce # 臨時切成寬松模式重啟后恢復 setenforce 0更規(guī)范的做法是在掛載參數(shù)后面加:z或:Z讓 Docker 自動打上 SELinux 標簽比如-v /data/docker/mysql/data:/var/lib/mysql:z。兩種做法選一種別同時上否則排查時根本分不清是哪個改動起的作用。權限本身也要看一眼/data/docker/mysql/data如果被 root 提前占成 700容器內的 mysql 用戶寫不進去同樣起不來。chown -R 999:999 /data/docker/mysql/data把屬主對齊到容器內的 mysql uid這是mysql:8.0.24鏡像里的固定值。6. 驗收load 之后用三條命令確認容器真的在跑最后這步是我現(xiàn)在每次遷移必走的幾分鐘就能把“看起來起來了”和“真的能對外服務”區(qū)分開。第一步看容器狀態(tài)三個容器都得是Up重啟次數(shù)是 0docker ps --format table {{.Names}}\t{{.Status}}\t{{.Ports}}第二步驗端口和服務。從 Linux 本機curl應用首頁curl不通就先看容器日志別急著改配置# 應用返回 200 或者一段 HTML 才算數(shù) curl -I http://127.0.0.1:8080 # 日志只取最后 50 行重點找 Started Application 和異常堆棧 docker logs --tail 50 demo-app # 從應用容器反向驗證數(shù)據(jù)庫端口能連上會打印 Open 或空行后掛住 docker exec -it demo-app sh -c nc -zv mysqldoc 3306nc在 alpine 里通常可用不行就用ping加docker exec -it mysqldoc mysql -uroot -p -e select 1從數(shù)據(jù)庫側驗證。第三步是最容易被跳過、也最能暴露問題的一步跑一次真實的讀寫。打開一個涉及數(shù)據(jù)庫查詢的頁面或者調一個寫接口然后去數(shù)據(jù)庫里select一下確認數(shù)據(jù)落庫了再往 Redis 里寫一個 key用客戶端查出來。只驗證首頁能打開是不夠的首頁往往是靜態(tài)的連接池根本沒被觸發(fā)。驗證項命令或動作通過標準容器存活docker ps三個容器 Up重啟次數(shù) 0應用可達curl -I http://127.0.0.1:8080返回 200 或 3xx數(shù)據(jù)庫連通頁面觸發(fā)查詢返回數(shù)據(jù)無Connection refused數(shù)據(jù)落盤寫接口后查庫數(shù)據(jù)能查到容器重啟后還在Redis 連通寫 key 后用客戶端讀讀得到值PING返回PONG開機自啟重啟機器后docker ps三個容器自動起來那次在 CentOS 上 load 完鏡像、docker ps三個容器全是 Up、首頁也能打開我直接跟人說好了結果業(yè)務同事一點查詢就報錯——yml里還寫著 Windows 上那個127.0.0.1:3307容器里根本沒有這個地址。從那以后我每次遷移完都強制走一遍“容器狀態(tài) → 端口連通 → 真實讀寫”這套動作一步都不跳。希望這套流程能幫到你少在黑匣子日志里繞幾圈。本文還有配套的精品資源點擊獲取 SpringBoot Docker鏡像跨平臺部署與Linux驗收
簡介這是一份面向 Java 后端開發(fā)者與運維初學者的 Docker 部署實踐文檔圍繞在 Windows 環(huán)境中將 SpringBoot 項目構建為鏡像并遷移到 Linux 主機運行展開。內容從 Dockerfile 基礎寫法切入串聯(lián) jar 包復制、端口暴露、鏡像構建、容器啟動與日志查看并延伸到容器網絡連通性測試、宿主機或獨立 MySQL 容器訪問、數(shù)據(jù)庫掛載目錄持久化等常見問題。文檔還涉及共享主機網絡、ping 與 telnet 排查、Docker Compose 管理多容器應用等排錯思路對鏡像命名、端口沖突、容器重啟策略、MySQL 初始化密碼與目錄映射等細節(jié)也有交代幫助讀者理解鏡像、容器與數(shù)據(jù)卷之間的關系形成從本地開發(fā)機到 Linux 部署環(huán)境的完整參考。文件包共 1 個 docx約 2.48MB以圖文說明和命令示例為主便于對照實踐。已有 135 人學習適合作為 SpringBoot 容器化入門與跨平臺部署的實操資料。1. Windows 里把鏡像跑起來只是前半場搬到 Linux 才是真正的驗收在 Windows 上把 SpringBoot 項目打成 Docker 鏡像、docker run起容器、瀏覽器打開 8080 看到首頁很多人到這一步就收工了等docker save出一個幾百兆的 tar 丟到 Linux 上docker load起來容器啟動幾秒就退出日志里一行Connection refused指向數(shù)據(jù)庫才發(fā)現(xiàn)這套環(huán)境從來不是“裝個 Docker”這么簡單。Dockerfile 里 jar 路徑寫錯容器網絡默認橋接解析不了容器名MySQL 數(shù)據(jù)目錄掛載權限對不上Linux 上的 docker-ce 版本比鏡像還老任何一處都能讓頁面白屏。這套流程適合手上有 SpringBoot MySQL Redis、想在 Windows 上開發(fā)調試、再把同一份鏡像搬到 Linux 跑起來的人。下面按裝什么、怎么裝、壞了怎么救走一遍。2. Dockerfile 落地openjdk:8-jdk-alpine 五行寫死一個可移植鏡像鏡像能不能在另一臺機器上活著跑起來八成取決于 Dockerfile 里那幾個路徑和基礎鏡像選得對不對。這一章先把項目結構釘死再逐行拆一份能直接抄的 Dockerfile最后把docker build和docker run兩刀砍下去。2.1 先把 jar 包位置和 Dockerfile 擺放位置固定下來SpringBoot 項目打包用 Maven 就是一條命令產出的 jar 默認落在target目錄下名字帶版本號。真正容易翻車的是位置Dockerfile必須放在項目根目錄也就是pom.xml同級因為它決定了docker build的構建上下文build contextCOPY后面的源路徑永遠是相對這個上下文算的不是相對Dockerfile所在行的位置。springboot-demo/ ├── pom.xml ├── Dockerfile - 必須在這一層 ├── src/ │ └── main/java/... └── target/ └── demo-app-1.0.0.jar - mvn package 之后才有打包命令用跳過測試的那條本地驗證過功能再跳別在 CI 里也一路跳過# 清理舊產物并跳過測試打包產物落在 target/ 下 mvn clean package -DskipTests打包完先ls target/*.jar看一眼真實文件名。target目錄里經常還有xxx.jar.original這種后綴COPY target/*.jar app.jar在某些情況下會匹配到多個文件直接報錯所以我在正式 Dockerfile 里一律寫死完整文件名寧可改一次 Dockerfile 也不留這個隱患。如果你的項目名和版本號經常變那就退一步用COPY target/*.jar前先確認target下只有一個 jar或者加.dockerignore把*.original排除掉。2.2 逐行拆 DockerfileFROM、WORKDIR、COPY、EXPOSE、ENTRYPOINT這是能直接用的版本比原始寫法多了一個時區(qū)參數(shù)原因后面講# 基礎鏡像用 OpenJDK 8 的 alpine 精簡版體積小夠跑 SpringBoot FROM openjdk:8-jdk-alpine # 容器內的工作目錄后面的相對路徑都基于它 WORKDIR /app # 把本地構建出的 jar 復制進鏡像并重命名為固定的 app.jar COPY target/demo-app-1.0.0.jar app.jar # 聲明應用監(jiān)聽 8080屬于元數(shù)據(jù)不做端口映射 EXPOSE 8080 # 啟動命令exec 形式PID 1 就是 java 進程 ENTRYPOINT [java, -Duser.timezoneAsia/Shanghai, -jar, /app/app.jar]FROM選openjdk:8-jdk-alpine的理由很實際SpringBoot 2.x 配 JDK 8 是主流組合alpine 版本鏡像只有百來兆推來推去不心疼。要注意 alpine 里沒有 glibc項目如果依賴 netty-tcnative 或者某些本地庫運行時會報Error loading shared library這種項目就得換openjdk:8-jdk-slim這類基于 Debian 的鏡像。WORKDIR /app不只是切目錄它會在鏡像層里創(chuàng)建這個目錄后面的COPY和ENTRYPOINT里寫/app/app.jar才對得上。COPY的兩個參數(shù)順序是“源 目標”源必須在構建上下文里../target/xxx.jar這種寫法直接失敗因為上下文之外的文件 Docker 看不見。EXPOSE 8080只是聲明不 publish真正對外還得靠docker run -p。寫它的價值在于別人docker inspect鏡像時能看到這個服務該用哪個端口。ENTRYPOINT用 JSON 數(shù)組的 exec 形式不是ENTRYPOINT java -jar app.jar這種 shell 形式。區(qū)別很致命shell 形式下 PID 1 是/bin/sh -cjava 進程是子進程docker stop發(fā)的 SIGTERM 到不了 JVM容器只能等 10 秒超時后被 SIGKILL 強殺SpringBoot 的優(yōu)雅停機、連接池關閉全都不執(zhí)行。這個坑在開發(fā)環(huán)境看不出來上了 Linux 跑久了才會發(fā)現(xiàn)每次重啟都丟在途請求。時區(qū)參數(shù)-Duser.timezoneAsia/Shanghai是我必加的。alpine 鏡像默認 UTC容器里new Date()出來的時間比北京時間少 8 小時日志時間戳全是錯的排查問題時能把人繞暈。alpine 里沒裝 tzdata所以配TZ環(huán)境變量沒用直接給 JVM 傳時區(qū)最省事。2.3 docker build 后面那個點以及鏡像命名和緩存構建命令在 PowerShell 里執(zhí)行先cd到含Dockerfile的項目根目錄# -t 指定鏡像名和標簽最后那個點代表當前目錄作為構建上下文 docker build -t demo-app:1.0.0 .那個.是最容易被忽略又最容易出事的地方。它把當前目錄整個打包發(fā)給 Docker daemontarget里幾百兆的 jar、.git目錄、node_modules都會被送進去構建慢得像卡住。常見做法是在項目根目錄放一個.dockerignore.git .idea *.iml target/*.original logs/注意別把target/整個排除掉jar 就在里面COPY會直接失敗。-t demo-app:1.0.0的命名建議固定成“項目名:版本號”后面在 Linux 上docker save、docker load、docker run全程用這個名字版本號跟著pom.xml走。見過有人用docker build -t app .結果本地攢了七八個同名不同內容的app:latest出問題時根本分不清跑的是哪個包這就是自找的。緩存問題也得提一句。COPY target/xxx.jar app.jar這一行只要 jar 內容變了緩存就失效后面的層全部重建這是正常的。但如果改完代碼忘了mvn packageCOPY拿到的還是舊 jar構建依然“成功”容器里的代碼卻是老的排查半天以為是環(huán)境問題。我一般把打包和構建串成一條命令mvn clean package -DskipTests; if ($?) { docker build -t demo-app:1.0.0 . }if ($?)是 PowerShell 里判斷上一條命令是否成功打包失敗就不構建省得拿著舊包騙自己。2.4 起容器、看日志、確認端口映射# -d 后臺運行-p 宿主機端口:容器端口--name 給容器起個固定名字 docker run -d -p 8080:8080 --name demo-app demo-app:1.0.0 # 看容器是否還活著STATUS 里出現(xiàn) Up 才算數(shù) docker ps # 跟蹤日志出問題第一眼看這里 docker logs -f demo-app-p 8080:8080左邊是 Windows 宿主機端口右邊是容器內端口右邊必須和 Dockerfile 里EXPOSE以及 SpringBoot 的server.port一致。左邊被占用是最常見的啟動失敗原因比如本機已經跑了一個 Tomcat 或者另一個 SpringBootdocker run會直接報port is already allocated改左邊的端口就行比如-p 8081:8080。docker logs是這套環(huán)境的黑匣子。SpringBoot 啟動失敗都會在日志里留下痕跡UnknownHostException指向數(shù)據(jù)庫地址解析不了Access denied for user指向賬號密碼或授權范圍不對Communications link failure指向網絡不通。容器剛起來就退出的時候docker ps看不到它得用docker ps -a找再docker logs看退出原因。瀏覽器訪問http://localhost:8080能出頁面說明 Dockerfile、構建、端口映射這三段路是通的。但頁面能出來不代表業(yè)務能跑只要涉及數(shù)據(jù)庫查詢下一步就得處理容器怎么連到 MySQL。3. 容器網絡與中間件dev_net、MySQL 8.0.24 和 Redis 怎么串起來Windows 上跑容器訪問本機數(shù)據(jù)庫是這套流程里最容易“看起來通了其實沒通”的一段。原文里試過--nethost也試過先 ping 再改配置我把順序重新理一遍順手把 MySQL 和 Redis 也容器化。3.1 默認 bridge 解析不了容器名dev_net 才行Docker 容器默認掛在bridge網絡上這個默認網絡只有 IP 轉發(fā)沒有內嵌 DNS容器之間用容器名互相訪問會直接報UnknownHostException。自己docker network create出來的用戶自定義網絡才帶 DNS 解析容器名可以直接當主機名用。# 創(chuàng)建一個自定義橋接網絡后面的應用、MySQL、Redis 都接進來 docker network create dev_net # 看網絡列表確認 dev_net 在里面 docker network ls接入用docker network connect容器跑起來之后也能接不用重建docker network connect dev_net mysqldoc docker network connect dev_net redis docker network connect dev_net demo-app應用容器這一步經常被漏掉。MySQL 和 Redis 都連上dev_net了應用還在默認bridge上照樣解析不了mysqldoc。三條connect一條都不能少接了之后用docker inspect驗一下# 只取容器在 dev_net 里的 IP有輸出說明接上了 docker inspect -f {{range $k, $v : .NetworkSettings.Networks}}{{$k}} {{$v.IPAddress}}{{end}} demo-app3.2 從容器里 ping 和 telnet 3306先判斷再改配置連不上數(shù)據(jù)庫時別急著改 yml先在容器里做兩步診斷。原始做法是從應用容器 ping 數(shù)據(jù)庫容器或 IP再 telnet 3306 端口。# 容器內 ping 數(shù)據(jù)庫容器名驗證 DNS 解析和二層連通 docker exec -it demo-app ping mysqldoc # 容器內 telnet 數(shù)據(jù)庫端口驗證 TCP 層通不通 docker exec -it demo-app telnet mysqldoc 3306這里有個現(xiàn)實問題openjdk:8-jdk-alpine鏡像里既沒有ping也沒有telnet直接執(zhí)行會報not found。常見做法是臨時進容器裝一個 busybox 擴展或者反過來從 MySQL 容器往應用容器 ping因為mysql:8.0.24鏡像里通常有ping。更省事的做法是# 用自帶 bash 的容器做網絡探測把它接到同一個網絡里 docker run --rm --net dev_net busybox ping -c 2 mysqldoc--rm表示跑完即刪不留垃圾容器--net dev_net讓它和業(yè)務容器在同一個網絡里這樣測出來的結果才有參考價值。ping 通只說明網絡層沒問題3306 還得單獨驗端口沒監(jiān)聽或者 MySQL 沒起來ping 是通但 telnet 不通的。3.3 MySQL 8.0.24 容器化四個掛載目錄和 3307 端口Windows 上先建掛載目錄PowerShell 里一條mkdir可以帶多個路徑mkdir D:\development_sources\docker\mysql\log,D:\development_sources\docker\mysql\data,D:\development_sources\docker\mysql\conf,D:\development_sources\docker\mysql\mysql-files然后跑容器參數(shù)一個一個擺開docker run -p 3307:3306 --restartalways --name mysqldoc -v D:\development_sources\docker\mysql\log:/var/log/mysql -v D:\development_sources\docker\mysql\data:/var/lib/mysql -v D:\development_sources\docker\mysql\conf:/etc/mysql -v D:\development_sources\docker\mysql\mysql-files:/var/lib/mysql-files -e MYSQL_ROOT_PASSWORDroot -d mysql:8.0.24PowerShell 里的續(xù)行符是反引號別抄成 Linux 的反斜杠\抄錯了命令會被拆成幾條執(zhí)行報一堆莫名其妙的錯。參數(shù)作用取舍說明-p 3307:3306宿主機 3307 映射容器 3306本機已有 MySQL 占了 3306開發(fā)機這樣錯開最省事--restartalways容器異常退出或 Docker 重啟后自動拉起開發(fā)機也建議加省得每次開機手動 start--name mysqldoc固定容器名后面容器名要寫進 yml名字不能亂改-v .../log:/var/log/mysql日志落宿主機出問題直接在 Windows 上看日志文件-v .../data:/var/lib/mysql數(shù)據(jù)文件落宿主機容器刪了數(shù)據(jù)還在這條是命根子-v .../conf:/etc/mysql配置文件掛進去想改my.cnf不用進容器-v .../mysql-files:/var/lib/mysql-files導入導出目錄LOAD DATA之類操作要用-e MYSQL_ROOT_PASSWORDrootroot 初始密碼只在數(shù)據(jù)目錄為空、首次初始化時生效最后一條特別容易誤解MYSQL_ROOT_PASSWORD只在/var/lib/mysql為空、容器執(zhí)行初始化時讀取。掛載目錄里已經有數(shù)據(jù)了改這個環(huán)境變量密碼不會變得進容器用ALTER USER改。容器起來后用數(shù)據(jù)庫客戶端連127.0.0.1:3307驗證注意端口是 3307 不是 3306。業(yè)務賬號別直接用 root在容器里建一個限定來源的賬號# 進入容器內的 mysql 客戶端 docker exec -it mysqldoc mysql -uroot -p-- 應用賬號只允許從任意容器來源連接密碼自己換掉 CREATE USER app_user% IDENTIFIED BY App123456; GRANT ALL PRIVILEGES ON app_db.* TO app_user%; FLUSH PRIVILEGES; -- 如果只允許某個固定 IP 來源把 % 換成具體地址 -- CREATE USER app_user192.168.0.27 IDENTIFIED BY App123456;MySQL 8 的默認認證插件是caching_sha2_password老的 JDBC 驅動連它會報Public Key Retrieval is not allowed所以后面 JDBC URL 里要帶allowPublicKeyRetrievaltrue或者把賬號改成mysql_native_password。這兩條路選一條別兩邊都改完再互相干擾。3.4 Redis 容器6380 端口、AOF 和密碼Redis 的部署結構簡單得多一個數(shù)據(jù)目錄就夠mkdir D:\development_sources\docker\redis\data docker run -p 6380:6379 --restartalways --name redis -v D:\development_sources\docker\redis\data:/data -d redis redis-server --appendonly yes --requirepass redis-p 6380:6379同樣是為了避開宿主機已經占用的 6379。--appendonly yes打開 AOF 持久化每條寫命令追加到文件容器重啟后數(shù)據(jù)能重建不打開的話重啟即清空開發(fā)環(huán)境丟點緩存無所謂但如果拿 Redis 存了業(yè)務狀態(tài)就會出事。--requirepass redis設密碼最后這幾個參數(shù)是傳給redis-server的命令行參數(shù)順序必須在鏡像名之后寫到鏡像名前面會被 Docker 當成自己的參數(shù)而報錯。容器起來后docker network connect dev_net redis接進同一個網絡再用 Redis 桌面客戶端連127.0.0.1:6380密碼填redis能PING出PONG就算通了。3.5 yml 里寫容器名還是 IP以及 --nethost 在 Windows 上的局限網絡通了之后改 SpringBoot 的配置文件host直接寫容器名spring: datasource: url: jdbc:mysql://mysqldoc:3306/app_db?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/ShanghaiuseSSLfalseallowPublicKeyRetrievaltrue username: app_user password: App123456 redis: host: redis port: 6379 password: redis兩個端口別寫錯容器內 MySQL 永遠是 3306Redis 永遠是 63793307和6380只是宿主機映射出去給 Windows 上的客戶端用的。在 yml 里寫成 3307容器之間是連不上的這個錯我見過不止一次。serverTimezoneAsia/Shanghai和前面 JVM 的時區(qū)參數(shù)是一套的兩邊都不寫插入的時間字段就會差 8 小時。useSSLfalse在開發(fā)環(huán)境關掉省事生產環(huán)境該開還得開。至于--nethost原文試過之后評價“意義不大”我補一下原因Windows 上的 Docker Desktop 跑在一層輕量虛擬機里--nethost共享的是那臺虛擬機的網絡棧不是 Windows 宿主機本身所以想靠它連 Windows 上的 MySQL大概率還是不通。Linux 上--nethost是真共享宿主機網絡行為完全不同?？缙脚_部署時這個差異足夠讓人懷疑人生所以我的做法是統(tǒng)一走dev_net加容器名Windows 和 Linux 行為一致遷移的時候不用改配置。4. 避坑與排查容器起不來、連不上庫的五個現(xiàn)場下面五條都是我自己踩過或者幫別人收拾過的現(xiàn)場按“現(xiàn)象 → 原因 → 解決”記。4.1 構建和啟動階段的三條第一條容器啟動幾秒就 Exiteddocker ps里看不到?，F(xiàn)象docker run回車后返回一串容器 IDdocker ps空空如也docker ps -a能看到狀態(tài)是Exited (1)。原因九成是 jar 路徑不對或者 jar 本身沒打出來。COPY在構建階段就會失敗但如果是ENTRYPOINT里的路徑寫錯構建能過運行時 java 找不到 jar 直接退出。解決先docker logs 容器名看最后幾行典型報錯是Error: Unable to access jarfile /app/app.jar?；氐巾椖坷飈s target/*.jar確認文件名再核對COPY的目標名和ENTRYPOINT里的是否一致順便確認mvn package真的執(zhí)行過別拿著空target目錄構建。第二條改了代碼鏡像重建了容器里跑的還是老邏輯?，F(xiàn)象接口返回的字段和本地代碼對不上日志里的時間戳也停在幾小時前。原因docker build用了緩存或者更常見的是打包那步漏了COPY復制進去的就是舊 jar。Docker 只按文件內容算哈希內容沒變就復用緩存層它不會知道你改的是src里的 java 文件。解決養(yǎng)成mvn clean package再docker build的固定順序懷疑緩存問題時加--no-cachedocker build --no-cache -t demo-app:1.0.0 .--no-cache會把所有層重建慢但干凈。另外docker run前先docker rm -f demo-app刪舊容器不然--name沖突會直接報錯有人以為報錯就是構建失敗其實只是名字被占了。第三條docker run報端口已被占用?，F(xiàn)象Bind for 0.0.0.0:8080 failed: port is already allocated。原因宿主機 8080 已經被別的進程或容器占著Windows 上常見的是另一份 SpringBoot 在 IDEA 里跑著沒關或者上次的容器沒刪干凈。解決netstat -ano | findstr :8080找到占用進程該關的關掉不想關就換映射端口-p 8081:8080容器內還是 8080對外訪問改成 8081 即可。別去改 Dockerfile 里的EXPOSE那是元數(shù)據(jù)改了也解決不了沖突。4.2 連庫和遷移階段的兩條第四條容器里訪問數(shù)據(jù)庫報UnknownHostException: mysqldoc?，F(xiàn)象應用啟動日志里拋java.net.UnknownHostException或者Communications link failure但用數(shù)據(jù)庫客戶端從 Windows 連127.0.0.1:3307是好的。原因應用容器和 MySQL 容器不在同一個用戶自定義網絡上默認bridge沒有 DNS 解析容器名根本不是一個能解析的主機名。解決確認三方都接進了dev_netdocker network inspect dev_net看Containers里是不是三個容器都在。少哪個就docker network connect dev_net 名字補上然后重啟應用容器讓 SpringBoot 重新解析。還有一種情況是 yml 里寫了容器的 IP容器重建后 IP 變了所以寫容器名、不寫 IP。第五條數(shù)據(jù)庫容器升級或者換機器后數(shù)據(jù)“沒了”?，F(xiàn)象在 Windows 上跑得好好的庫換到 Linux 上重新docker run之后表全空只剩一個空庫。原因-v掛的是宿主機目錄換機器等于換了一個空目錄MySQL 發(fā)現(xiàn)/var/lib/mysql為空就重新初始化。容器本身不會隨鏡像帶走數(shù)據(jù)這點和鏡像完全兩回事。解決遷移前先mysqldump導出 SQL在新機器上起容器、建庫、導數(shù)據(jù)不要指望把 Windows 的數(shù)據(jù)目錄直接拷到 Linux 上能用——目錄里的文件屬主是容器內的 mysql 用戶uid 通常是 999Linux 上權限對不上容器會起不來日志里一堆Permission denied。如果非要拷目錄得在新機器上chown -R 999:999對齊 uid還得處理 SELinux 上下文不如導出導入干凈。5. 遷移到 Linuxdocker save 打包 CentOS 7 裝 docker-ce-18.03.1.ceWindows 那邊驗證通過了接下來的活是把鏡像搬到 Linux。核心就三件事docker save出 tar、目標機裝 Docker、docker load回來重跑。5.1 docker save 三個 tar應用、MySQL、Redis鏡像必須一個一個存docker save一條命令只打包一個鏡像新版本可以帶多個鏡像名但老版本不行別賭# -o 指定輸出文件后面跟鏡像名:標簽 docker save -o demo-app.tar demo-app:1.0.0 docker save -o mysqlimage.tar mysql:8.0.24 docker save -o myredisimage.tar redis三個 tar 都要存因為 Linux 上的 Docker 不保證能拉到完全一樣的鏡像尤其是沒有外網或者鏡像站抽風的時候。文件大小心里要有數(shù)MySQL 8.0.24 的鏡像 tar 通常幾百兆應用鏡像看依賴幾十兆到幾百兆。三個加起來超過 1G 很正常傳輸前先看目標盤的剩余空間。鏡像名和標簽要和 Linux 上docker run用的完全一致save的時候寫mysql:8.0.24load回來就還是mysql:8.0.24寫mysql不帶標簽load 回來就是mysql:latest后面啟動腳本里的標簽對不上容器起不來。這個細節(jié)我吃過虧現(xiàn)在 save 之前都先docker images抄一遍完整名字。還有一個跨架構的注意點Windows 上的 Docker Desktop 默認拉的是linux/amd64架構的鏡像和 x86_64 的 CentOS 7 一致正常不會出問題。如果構建機是 ARM 架構就得在docker build時顯式指定--platform linux/amd64否則 load 到 Linux 上會報no matching manifest或者容器起來直接exec format error。5.2 CentOS 7 上裝 docker-ce-18.03.1.ce源、依賴、啟動Linux 側先確認版本內核 3.10 的 CentOS 7 是這套組合里最常見的底子uname -r # 3.10.0-1062.56.1.el7.x86_64遠程連接工具隨便挑一個順手的 SSH 客戶端輸入 IP、端口、賬號密碼連上命令行和文件管理都在一個界面里后面?zhèn)?tar 包方便。開發(fā)環(huán)境為了省事經常直接關防火墻生產環(huán)境千萬別這么干# 關閉防火墻并禁用開機自啟僅限內網開發(fā)環(huán)境 systemctl stop firewalld systemctl disable firewalld裝 Docker 之前先把舊版本清干凈CentOS 7 上有些老包會互相干擾# 卸載可能存在的舊版本沒裝過會提示 nothing to do正常 yum remove docker docker-common docker-selinux docker-engine # yum-utils 提供 yum-config-manager另外兩個是存儲驅動依賴 yum install -y yum-utils device-mapper-persistent-data lvm2 # 添加 docker-ce 的 yum 源地址換成你環(huán)境能訪問的鏡像站 yum-config-manager --add-repo http://你的鏡像站地址/docker-ce/linux/centos/docker-ce.repo # 列出可安裝版本從高到低排序 yum list docker-ce --showduplicates | sort -r # 安裝指定版本這是我們這套環(huán)境驗證過的版本 yum -y install docker-ce-18.03.1.ce版本這里要留意 yum 包名的完整形式實際的包名通常是docker-ce-18.03.1.ce-1.el7.centosyum install docker-ce-18.03.1.ce能匹配到就可以匹配不到就用yum list輸出里的全名。18.03 這個版本比較老好處是和舊內核、舊鏡像兼容性好壞處是有些新鏡像的 manifest 格式它不認。如果docker load時報格式相關的錯不要硬扛記下報錯信息確認鏡像能在更新的 Docker 上 load 成功再決定要不要升版本。裝完啟動并設開機自啟systemctl start docker systemctl enable docker # 確認版本Client 和 Server 兩段都要有輸出 docker versionCentOS 7 上默認存儲驅動可能是devicemapper性能和穩(wěn)定性都不如overlay2。內核 3.10 是支持 overlay2 的建議顯式寫進配置{ storage-driver: overlay2, log-driver: json-file, log-opts: { max-size: 100m, max-file: 3 } }把這段寫進/etc/docker/daemon.json然后systemctl restart docker。日志限制那兩行是后悔藥不加的話容器日志會把磁盤寫滿等到no space left on device的時候服務已經掛了。改完存儲驅動如果起不來先docker info | grep -i storage看實際生效的驅動必要時把/var/lib/docker清空重來——前提是沒有重要鏡像所以這一步要在 load 之前做。5.3 上傳 tar 包、load 鏡像、按 Linux 的路徑重跑容器用 SSH 客戶端的文件管理把三個 tar 傳到 Linux 的自定義目錄比如/opt/loadimages然后逐個加載cd /opt/loadimages # -i 指定輸入文件執(zhí)行完 docker images 能看到鏡像 docker load -i demo-app.tar docker load -i mysqlimage.tar docker load -i myredisimage.tar # 確認三個鏡像都在標簽對得上 docker imagesdocker load可能輸出Loaded image: demo-app:1.0.0也可能只輸出層 ID 的進度最后以docker images的結果為準。容器要按 Linux 的路徑重跑不能照抄 Windows 的D:\...。先建目錄mkdir -p /data/docker/mysql/{log,data,conf,mysql-files} mkdir -p /data/docker/redis/dataMySQL 和 Redis 的啟動命令除了掛載路徑其余參數(shù)和 Windows 上保持一致docker network create dev_net docker run -p 3307:3306 --restartalways --name mysqldoc \ -v /data/docker/mysql/log:/var/log/mysql \ -v /data/docker/mysql/data:/var/lib/mysql \ -v /data/docker/mysql/conf:/etc/mysql \ -v /data/docker/mysql/mysql-files:/var/lib/mysql-files \ -e MYSQL_ROOT_PASSWORDroot \ -d mysql:8.0.24 docker run -p 6380:6379 --restartalways --name redis \ -v /data/docker/redis/data:/data \ -d redis redis-server --appendonly yes --requirepass redis docker run -d -p 8080:8080 --name demo-app demo-app:1.0.0 docker network connect dev_net mysqldoc docker network connect dev_net redis docker network connect dev_net demo-app順序上先把中間件起好再起應用不然應用啟動時連不上數(shù)據(jù)庫SpringBoot 可能直接啟動失敗。數(shù)據(jù)從 Windows 遷過來的話用mysqldump導出的 SQL 在新容器里source一遍別直接拷數(shù)據(jù)目錄。5.4 SELinux 和目錄權限CentOS 上特有的兩個坑CentOS 7 默認開著 SELinux-v掛載宿主機目錄時容器進程可能沒有寫權限表現(xiàn)是 MySQL 容器啟動失敗日志里Cant create/write to file或者Permission denied。開發(fā)環(huán)境圖省事可以臨時關掉# 查看當前狀態(tài)Enforcing 表示開著 getenforce # 臨時切成寬松模式重啟后恢復 setenforce 0更規(guī)范的做法是在掛載參數(shù)后面加:z或:Z讓 Docker 自動打上 SELinux 標簽比如-v /data/docker/mysql/data:/var/lib/mysql:z。兩種做法選一種別同時上否則排查時根本分不清是哪個改動起的作用。權限本身也要看一眼/data/docker/mysql/data如果被 root 提前占成 700容器內的 mysql 用戶寫不進去同樣起不來。chown -R 999:999 /data/docker/mysql/data把屬主對齊到容器內的 mysql uid這是mysql:8.0.24鏡像里的固定值。6. 驗收load 之后用三條命令確認容器真的在跑最后這步是我現(xiàn)在每次遷移必走的幾分鐘就能把“看起來起來了”和“真的能對外服務”區(qū)分開。第一步看容器狀態(tài)三個容器都得是Up重啟次數(shù)是 0docker ps --format table {{.Names}}\t{{.Status}}\t{{.Ports}}第二步驗端口和服務。從 Linux 本機curl應用首頁curl不通就先看容器日志別急著改配置# 應用返回 200 或者一段 HTML 才算數(shù) curl -I http://127.0.0.1:8080 # 日志只取最后 50 行重點找 Started Application 和異常堆棧 docker logs --tail 50 demo-app # 從應用容器反向驗證數(shù)據(jù)庫端口能連上會打印 Open 或空行后掛住 docker exec -it demo-app sh -c nc -zv mysqldoc 3306nc在 alpine 里通常可用不行就用ping加docker exec -it mysqldoc mysql -uroot -p -e select 1從數(shù)據(jù)庫側驗證。第三步是最容易被跳過、也最能暴露問題的一步跑一次真實的讀寫。打開一個涉及數(shù)據(jù)庫查詢的頁面或者調一個寫接口然后去數(shù)據(jù)庫里select一下確認數(shù)據(jù)落庫了再往 Redis 里寫一個 key用客戶端查出來。只驗證首頁能打開是不夠的首頁往往是靜態(tài)的連接池根本沒被觸發(fā)。驗證項命令或動作通過標準容器存活docker ps三個容器 Up重啟次數(shù) 0應用可達curl -I http://127.0.0.1:8080返回 200 或 3xx數(shù)據(jù)庫連通頁面觸發(fā)查詢返回數(shù)據(jù)無Connection refused數(shù)據(jù)落盤寫接口后查庫數(shù)據(jù)能查到容器重啟后還在Redis 連通寫 key 后用客戶端讀讀得到值PING返回PONG開機自啟重啟機器后docker ps三個容器自動起來那次在 CentOS 上 load 完鏡像、docker ps三個容器全是 Up、首頁也能打開我直接跟人說好了結果業(yè)務同事一點查詢就報錯——yml里還寫著 Windows 上那個127.0.0.1:3307容器里根本沒有這個地址。從那以后我每次遷移完都強制走一遍“容器狀態(tài) → 端口連通 → 真實讀寫”這套動作一步都不跳。希望這套流程能幫到你少在黑匣子日志里繞幾圈。本文還有配套的精品資源點擊獲取