容器与云原生 / 系统课时
验证 Docker 环境
验证 Docker 环境
本课通过 docker version、docker info 和测试容器逐层检查 Docker 环境,帮助你确认客户端、守护进程、镜像下载与容器运行链路都已正常工作,并快速定位常见失败。
学习目标
- 检查 Docker 客户端与服务端是否能够正常通信
- 使用系统信息确认运行时和基础配置
- 通过测试容器完成最终验收并处理常见错误
先理解验证顺序
Docker 验证应按“命令是否存在、客户端能否连接服务端、容器能否实际运行”的顺序进行。只检查版本号不足以证明环境可用,因为客户端可能已经安装,但 Docker 守护进程尚未启动。
检查客户端与服务端版本
执行下面的命令查看客户端和服务端信息:
docker version正常情况下,输出中应同时出现 Client 和 Server 两部分,版本号会随实际安装版本变化:
Client: Docker Engine - Community
Version: <CLIENT_VERSION>
...
Server: Docker Engine - Community
Engine:
Version: <SERVER_VERSION>
...若只看到客户端信息,随后出现无法连接 Docker daemon 的错误,说明命令行工具已经存在,但守护进程未运行,或当前客户端连接到了错误的 Docker 上下文。
查看 Docker 系统信息
docker info 会读取服务端的容器数量、镜像数量、存储驱动、日志驱动和运行时等信息,比单纯查看版本更适合判断服务端是否真正可用。
docker info预期输出会包含类似字段,具体数值和驱动名称可能不同:
Server:
Containers: <COUNT>
Images: <COUNT>
Storage Driver: <DRIVER>
Logging Driver: <DRIVER>
Cgroup Driver: <DRIVER>
Docker Root Dir: <PATH>重点确认命令没有连接错误,并且 Docker Root Dir、存储驱动等服务端字段能够正常返回。首次安装时容器和镜像数量为 0 属于正常现象。
运行测试容器
下面的命令会拉取官方测试镜像、启动容器、打印结果,并在容器退出后自动删除容器实例:
docker run --rm hello-world首次执行可能先显示镜像下载过程,最终应看到下面的关键内容:
Hello from Docker!
This message shows that your installation appears to be working correctly.这一步同时验证了客户端请求、守护进程响应、镜像仓库访问、镜像解压、容器创建和标准输出。如果该命令成功,Docker 的基础运行链路已经打通。
处理常见失败
找不到 docker 命令
若终端提示 docker: command not found,通常是 Docker 尚未安装,或可执行文件不在 PATH 中。先重新打开终端;若仍然失败,应检查安装是否完成,而不是继续排查守护进程。
无法连接 Docker daemon
Linux 系统可以用 systemd 启动并检查 Docker 服务:
sudo systemctl enable --now docker
systemctl is-active docker预期输出:
active若状态不是 active,继续执行 systemctl status docker 或 journalctl -u docker 查看启动日志。Windows 和 macOS 使用 Docker Desktop 时,应先确认应用已经启动并显示 Docker 正在运行。
当前用户没有权限
Linux 上出现访问 /var/run/docker.sock 被拒绝时,可以暂时使用 sudo docker ... 验证,也可以把当前用户加入 docker 组:
sudo usermod -aG docker "$USER"
newgrp docker
docker info --format '{{.ServerVersion}}'预期输出为当前服务端版本:
<SERVER_VERSION>加入 docker 组后通常需要重新登录才能让所有终端会话生效。该组能够以接近 root 的权限控制主机,只有受信任用户才应加入。
镜像拉取失败
若 hello-world 在下载阶段失败,应检查 DNS、代理、防火墙和镜像仓库访问。此时 Docker 服务本身可能正常,可先运行下面的命令确认服务端仍能响应:
docker ps预期输出至少包含表头;没有正在运行的容器时,列表为空是正常的:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES最终验收标准
Docker 环境可以通过以下三个条件验收:docker version 同时返回客户端和服务端信息,docker info 能读取服务端配置,docker run --rm hello-world 能输出成功提示。三项都通过后,才说明环境不仅“安装过”,而且能够真正运行容器。
本课总结
docker version用于确认客户端与服务端通信docker info用于检查 Docker 运行时和系统配置- 测试容器成功运行,才算完成镜像下载与容器执行的最终验收
下一课预告
下一课将进入容器操作,学习如何拉取镜像、启动容器,并观察容器从创建到退出的基本生命周期。