docker ps
100%

Docker · 第 4 课

docker ps

学习如何列出 Docker 容器,并区分正在运行和已经退出的容器。

你在 Docker 中启动的 Web 服务器还在运行吗?用 docker ps 查一查。Docker 镜像打包了程序和所需文件,容器则是根据镜像创建的实例。这条命令显示执行时的容器列表。

列出正在运行的容器

默认情况下,docker ps 只列出正在运行的容器。下面的示例取自准备好的 Docker 环境,只保留了几列。不用搭建环境也能跟着读。如果在终端练习,请输入 $ 提示符后面的命令。

$ docker ps
IMAGE         STATUS         NAMES
nginx:alpine  Up 4 minutes   web
nginx:alpine  Up 30 seconds  demo

如果 Docker 只显示列标题,说明运行中的容器列表为空。这个环境里仍可能有已经停止的容器。

执行 docker ps 后,Docker 只显示列标题。从中能得出什么结论?

查看名称和状态

先看 NAMES 列,找到要检查的容器。两行的 IMAGE 列显示同一个镜像 nginx:alpine。在最右侧找到 web,再读同一行的 STATUS。Up 4 minutes 表示这个容器已经运行了大约四分钟。

哪一行的容器已经运行了大约 30 秒?

一并查看已退出的容器

如果没看到想找的容器,可以试试 docker ps -a。-a 是 --all 的简写,会把已经停止但仍存在的容器也列出来。这个例子还加入了一个预先准备好的任务 preview。

$ docker ps -a
IMAGE         STATUS                         NAMES
nginx:alpine  Up 4 minutes                   web
nginx:alpine  Up 30 seconds                  demo
busybox:1.36  Exited (0) 2 minutes ago       report
busybox:1.36  Exited (1) About a minute ago  preview

容器运行一个主程序,例如 Web 服务器或脚本。Exited 表示这个程序已经停止。括号里的数字是退出码,即程序停止时给出的结果。0 通常表示成功,非零退出码通常表示发生了错误。任务 report 显示 Exited (0),符合任务成功结束的正常表现。

LabEx 终端列出运行中和已退出的容器,report 的退出码为 0,preview 的退出码为 1

LabEx 截图只展示了四个示例容器的名称和状态。运行时长会随查看时间而变化。

仅根据退出码,你会先检查哪一行是否出错?

选择下一步检查

退出码可以帮助你决定下一步查什么。要看 preview 有没有报错,在 docker logs 后加上容器名称。这会显示 Docker 收集到的容器输出。

$ docker logs preview

对于正在运行的 Web 服务器,也可以检查访问者能不能打开网页。要确认这一点,请在需要访问服务的那台电脑上打开网页。Up 描述的是容器内程序的状态。在浏览器中成功打开网页,则表明从测试的电脑可以访问它。

在运行 Docker 的电脑上能打开网页。同事需要从另一台电脑访问。怎样才能确认对方可以访问?

课程已完成

你已完成 docker ps

现在,你可以用容器列表找到目标容器、读懂状态,并判断下一步该检查什么。

  • 用 docker ps 列出正在运行的容器。

  • 按名称找到容器并查看它的状态。

  • 用 docker ps -a 查看包括已退出容器在内的列表。

  • 通过日志或浏览器请求,检查容器状态无法说明的问题。

保存学习进度

创建免费账户即可保存本课进度,并在任意设备上继续学习。

创建免费账户
下一节
返回 Docker