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