我們?cè)陂_發(fā)部署的時(shí)候，用 Docker 打包環(huán)境，理論上是“我裝好了你就能跑”。但理想很豐滿，現(xiàn)實(shí)往往一 docker run 下去就翻車了。

今天來(lái)盤點(diǎn)一下我實(shí)際工作中經(jīng)常遇到的 Docker 容器啟動(dòng)失敗的常見原因，順便給點(diǎn) debug 的小技巧，能讓你從“容器起不來(lái)”到“穩(wěn)穩(wěn)跑起來(lái)”。

常見場(chǎng)景 1：鏡像構(gòu)建失敗，容器壓根沒(méi)起來(lái)

很多人以為“容器起不來(lái)”就是 docker run 的問(wèn)題，其實(shí)很多時(shí)候是在 docker build 階段就翻車了。

典型報(bào)錯(cuò)：

failed to solve with frontend dockerfile.v0: failed to read dockerfile: open /path/to/Dockerfile: no such file or directory

排查辦法：

• 檢查 Dockerfile 路徑是否正確；

• docker build 命令中 -f 指定的路徑是不是錯(cuò)了；

• COPY 和 ADD 的源路徑是不是寫對(duì)了，尤其是“相對(duì)路徑”。

小貼士：

如果你在構(gòu)建時(shí)卡住了，可以加上 --progress=plain 和 --no-cache 看得更清楚一點(diǎn)：

docker build --progress=plain --no-cache -t myimage .

常見場(chǎng)景 2：容器秒退，沒(méi)有主進(jìn)程 or 主進(jìn)程掛了

這個(gè)是真·經(jīng)典問(wèn)題。

典型表現(xiàn)：

容器剛啟動(dòng)立刻就退出了。比如：

docker run myimage
# 幾秒后
docker ps -a
# 狀態(tài)為 Exited (1)

原因分析：

• 沒(méi)有前臺(tái)進(jìn)程。容器是以主進(jìn)程是否在運(yùn)行為準(zhǔn)的，如果你在 Dockerfile 里 CMD ["nginx"] 啟了個(gè)守護(hù)進(jìn)程（daemon），容器就直接退出了。

• 程序一啟動(dòng)就報(bào)錯(cuò)，直接崩了。

怎么查：

docker logs <container-id>

如果啥都沒(méi)有，或者一眨眼就退了，可以加個(gè) -it，手動(dòng)起個(gè) bash 看：

docker run -it myimage /bin/bash

常見場(chǎng)景 3：端口沖突 / 未暴露端口

報(bào)錯(cuò)不一定明確：

有時(shí)候你在宿主機(jī)開了某個(gè)端口（比如本地的 nginx 占了 80），你再用 -p 80:80 就起不來(lái)了。

解決辦法：

• 用 docker ps 看看是不是端口已經(jīng)被別的容器占用了；

• 改用別的端口，比如：

docker run -p 8080:80 myimage

常見場(chǎng)景 4：環(huán)境變量配置錯(cuò)誤

比如你 Dockerfile 里寫了：

ENV DB_HOST=$DB_HOST

抱歉，這個(gè)語(yǔ)法會(huì)把 $DB_HOST 當(dāng)成字面量（字符串），并不會(huì)替換成你主機(jī)環(huán)境里的變量。

正確姿勢(shì)：

ARG DB_HOST
ENV DB_HOST=${DB_HOST}

然后 build 時(shí)傳參：

docker build --build-arg DB_HOST=127.0.0.1 -t myimage .

或者更簡(jiǎn)單地，在 run 的時(shí)候用 -e 指定：

docker run -e DB_HOST=127.0.0.1 myimage

常見場(chǎng)景 5：文件權(quán)限問(wèn)題

如果你在容器里掛載了宿主機(jī)的文件夾：

docker run -v /my/data:/app/data myimage

結(jié)果程序直接報(bào)權(quán)限錯(cuò)誤，比如：

Permission denied: '/app/data/output.log'

原因：

容器里運(yùn)行的用戶沒(méi)權(quán)限寫這個(gè)掛載目錄。

解決方法：

• 用 chown 改下宿主機(jī)的目錄權(quán)限；

• 或者加上 --user 參數(shù)運(yùn)行容器：

docker run --user $(id -u):$(id -g) -v /my/data:/app/data myimage

最后一個(gè)大招：用 --entrypoint 開 bash 進(jìn)去排查

如果你啥都試了都沒(méi)搞明白，那最后一個(gè)招就是手動(dòng)進(jìn)去看：

docker run --entrypoint /bin/bash -it myimage

進(jìn)去看看有沒(méi)有路徑寫錯(cuò)，權(quán)限不對(duì)，環(huán)境變量沒(méi)設(shè)之類的，通常都能找到線索。

小結(jié)

寫到這里你應(yīng)該對(duì)“容器為啥起不來(lái)”有些眉目了?？傊鄤?dòng)手、多看 log、多試試 -it 進(jìn)去看現(xiàn)場(chǎng)，慢慢你就會(huì)像老中醫(yī)一樣一眼看出問(wèn)題所在了。

以上就是Docker容器啟動(dòng)失敗的常見原因分析及解決方法的詳細(xì)內(nèi)容，更多關(guān)于Docker容器啟動(dòng)失敗原因的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

最新評(píng)論