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