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