容器与云原生 / 系统课时
怎样进入指定服务容器调试
怎样进入指定服务容器调试
当某个 Compose 服务“看起来在运行”却访问异常时,最直接的办法是进入该服务正在运行的容器,从容器自己的网络、环境变量和文件系统视角检查事实。本篇以 api 服务为例,完成 Shell、DNS、监听端口与配置检查。
学习目标
- 使用
docker compose exec进入指定服务的运行容器 - 从容器内部检查 DNS、端口、环境变量和配置文件
- 处理多副本服务以及镜像没有 Shell 或调试工具的情况
先确认服务正在运行
docker compose exec 面向的是 Compose 服务,不是手工拼出来的容器名。先确认 api 处于运行状态,再进入它;Compose 默认会为交互命令分配 TTY。
docker compose ps api
docker compose exec api sh预期输出:
NAME IMAGE COMMAND SERVICE CREATED STATUS PORTS
<CONTAINER_NAME> <IMAGE> <COMMAND> api <TIME> Up <TIME> <PORTS>
<PROMPT><CONTAINER_NAME>、<IMAGE>、<TIME>、<PORTS> 与 <PROMPT> 会随项目和镜像变化。进入成功后,后续命令看到的是容器内部环境,而不是宿主机环境。
在容器内部检查四类事实
下面假设镜像提供 sh、getent 与 ss。先看工作目录和 DNS 配置,再验证 Compose 服务名能否解析,随后检查容器内部监听端口和实际注入的环境变量。
pwd
cat /etc/resolv.conf
getent hosts db
ss -lnt
printenv | sort
exit预期输出:
<PATH>
nameserver <IP>
<IP> db
<LISTENING_PORTS>
<ENVIRONMENT_VARIABLES>实际内容会不同。getent hosts db 验证的是容器内对服务名 db 的解析;ss -lnt 看到的是容器网络命名空间中的监听端口,因此不要把宿主机发布端口和容器监听端口混为一谈。printenv 适合核对环境变量是否真的注入,但共享终端截图或日志前应避免暴露密码、令牌等敏感值。
如果问题指向配置文件,应在容器内读取应用实际使用的路径,并同时核对挂载点、文件权限和当前工作目录。关键是检查“进程此刻看到的配置”,而不是只看宿主机上你以为已经修改的文件。
多副本与最小镜像的边界
当同一服务有多个副本时,docker compose exec 默认只会选中一个实例;可用 --index 指定要进入的副本。排查负载不均、单实例异常时,应先确定具体副本,再比较它们的环境和运行状态。
有些 distroless 或极简镜像根本不包含 sh、bash、getent、ss 或 curl。此时出现 executable file not found 并不等于应用本身故障,而是调试工具不存在。不要为了临时排障随意改生产容器;优先执行镜像中已有的应用诊断命令,或使用专门的调试容器进入相同网络环境。
docker compose run 会启动一次性新容器,而 docker compose exec 是在已经运行的服务容器中执行命令。要检查当前进程、当前挂载和当前网络状态时,应优先使用 exec。