當你已經(jīng)構(gòu)建了一個 Docker 鏡像，但運行它的容器啟動后立即退出（通常是因為服務異常或配置錯誤），你仍然可以通過以下幾種方式進入鏡像內(nèi)部進行調(diào)試。

? 最佳實踐：如何對一個“啟動即退出”的鏡像進行命令行調(diào)試？

?? 目標

進入容器的命令行環(huán)境，即使它默認運行的服務會失敗。

? 方法一：使用 docker run 覆蓋 CMD，直接進入 shell

這是最推薦的方式。

?? 命令：

docker run -it --rm openeuler/dns:22.03-lts-sp4 /bin/sh

?? 說明：

• -it：啟用交互式終端。
• --rm：退出后自動刪除容器（臨時調(diào)試用）。
• /bin/sh：覆蓋鏡像的默認 CMD，不運行服務，而是進入 shell。
• 如果你的鏡像中沒有 bash，[sh](file://e:\docker_workspaces（svn.home）\base_systems\openEuler_dns\CreateContainer.sh) 通常是存在的。

?? 示例輸出：

/ # ls /etc/named.conf
/etc/named.conf

你可以在這個 Shell 中檢查配置文件、權(quán)限、用戶是否存在等問題。

? 方法二：使用 docker run + --entrypoint 進入（適用于自定義 ENTRYPOINT 的情況）

如果你的鏡像設置了 ENTRYPOINT（比如總是運行某個腳本），你可以通過 --entrypoint 覆蓋它。

?? 命令：

docker run -it --rm --entrypoint /bin/sh openeuler/dns:22.03-lts-sp4

?? 說明：

• --entrypoint 會忽略 Dockerfile 中定義的 ENTRYPOINT 和 CMD
• 然后你再手動執(zhí)行你想測試的命令，例如：

  /usr/sbin/named -g -c /etc/named.conf
  

? 方法三：創(chuàng)建一個新的調(diào)試鏡像（適合復雜場景）

如果你經(jīng)常需要調(diào)試這個鏡像，可以新建一個用于調(diào)試的鏡像，修改其行為。

1. 創(chuàng)建 [debug.Dockerfile](file://e:\docker_workspaces（svn.home）\base_systems\openEuler_dns\debug.Dockerfile) 文件：

FROM openeuler/dns:22.03-lts-sp4

# 覆蓋原 CMD，改為進入 Shell
CMD ["/bin/sh"]

2. 構(gòu)建調(diào)試鏡像：

docker build -f debug.Dockerfile -t openeuler/dns:debug .

3. 啟動并調(diào)試：

docker run -it --rm openeuler/dns:debug

這樣你就可以在一個和原鏡像幾乎一致的環(huán)境中進行排查了。

? 方法四：查看日志 + inspect 日志文件 + 掛載目錄分析

如果你只是想快速查看出錯原因，可以結(jié)合以下命令定位問題：

?? 查看容器日志：

docker logs <container_name_or_id>

?? 進入容器文件系統(tǒng)（即使沒運行）：

docker create --name debug-container openeuler/dns:22.03-lts-sp4
docker cp debug-container:/var/log/messages ./messages.log
cat ./messages.log

或者掛載目錄后查看文件：

docker run -it --rm -v ./debug:/mnt openeuler/dns:22.03-lts-sp4 /bin/sh
ls /mnt

? 方法五：使用 scratch 容器復制文件出來分析

有時你只需要看看里面的文件內(nèi)容而不運行服務本身。

docker create --name temp openeuler/dns:22.03-lts-sp4
docker cp temp:/etc/named.conf ./named.conf
docker rm temp

然后在宿主機上編輯、檢查配置。

? 方法六：使用 nsenter 進入容器命名空間（高級）

如果你有運行過的容器（哪怕只運行了幾秒），可以用 nsenter 進入其命名空間。

1. 查看容器 PID：

docker inspect <container_id> | grep HostPid

2. 使用 nsenter 進入：

sudo nsenter -t <PID> -m -u -i -n -p

這可以讓你看到容器內(nèi)完整的進程、網(wǎng)絡、掛載信息。

? 總結(jié)：不同場景下的調(diào)試策略

? 附注：如何查看容器退出原因？

docker inspect <container_id> | grep -i "exit_code"
# 或者
docker inspect <container_id> | grep -A 10 "State"

輸出示例：

"State": {
    "ExitCode": 1,
    "Error": "",
    "FinishedAt": "2025-05-20T12:00:00Z",
    "Running": false,
    "Paused": false,
    "Restarting": false,
    "OOMKilled": false,
    "Dead": false,
    "Pid": 0,
    "ExitCode": 1,
    "Error": "",
    "StartedAt": "2025-05-20T11:59:59Z",
    "FinishedAt": "2025-05-20T11:59:59Z"
}

如果 ExitCode != 0，表示非正常退出，結(jié)合日志進一步查錯。

? 最終建議流程

# 1. 進入容器 shell
docker run -it --rm openeuler/dns:22.03-lts-sp4 /bin/sh

# 2. 手動運行 DNS 服務以調(diào)試
/usr/sbin/named -g -c /etc/named.conf

# 3. 檢查文件權(quán)限
ls -l /var/named

# 4. 查看日志文件
cat /var/log/messages

# 5. 檢查 named 用戶是否存在
id named

如果你愿意貼出完整的 [Dockerfile](file://e:\docker_workspaces（svn.home發(fā)生異常，可以輸入更多信息再讓我來回答或重試

到此這篇關(guān)于Docker 鏡像調(diào)試的最佳實踐的文章就介紹到這了,更多相關(guān)Docker 鏡像調(diào)試內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論