容器与云原生 / 系统课时

查看容器列表

查看容器列表

本课解决“当前有哪些容器、它们处于什么状态”这一常见问题。你将掌握 docker ps 与 docker ps -a 的区别,并能按名称、状态、标签和退出码快速筛选目标容器。

学习目标

  • 区分运行中容器与全部容器列表
  • 使用常用过滤条件缩小查询范围
  • 自定义输出字段,快速定位状态异常

查看运行中与全部容器

docker ps 默认只显示正在运行的容器;docker ps -a 会同时显示已创建、运行中、已退出等全部容器。docker container ls 与 docker ps 等价,前者更符合 Docker 的分组命令风格。

下面用格式化输出避免默认表格过宽。时间、容器 ID 和状态持续时间会随实际环境变化。

bash
printf '=== running ===\n'
docker ps --format 'table {{.ID}}\t{{.Names}}\t{{.Status}}'
printf '=== all ===\n'
docker ps -a --format 'table {{.ID}}\t{{.Names}}\t{{.Status}}'

预期输出

text
=== running ===
CONTAINER ID   NAMES        STATUS
<ID>           api-server   Up <TIME>
=== all ===
CONTAINER ID   NAMES        STATUS
<ID>           api-server   Up <TIME>
<ID>           data-job     Exited (0) <TIME> ago

如果 docker ps 没有结果,不代表容器不存在,应继续使用 docker ps -a 检查它是否已经退出。

按名称和标签筛选

--filter 可以重复使用。不同类型的过滤条件会同时生效,因此结果必须同时满足名称与标签条件。名称过滤支持部分匹配,标签既可以只判断键是否存在,也可以匹配完整的 key=value。

bash
docker ps -a \
  --filter 'name=api' \
  --filter 'label=env=test' \
  --format 'table {{.Names}}\t{{.Image}}\t{{.Labels}}'

预期输出

text
NAMES        IMAGE          LABELS
api-server   <IMAGE>        env=test,<OTHER_LABELS>

查询不到结果时,先分别删除一个过滤条件运行,确认是名称不匹配,还是容器没有对应标签。

按状态和退出码筛选

状态过滤适合查找 running、exited、created、paused 等容器。退出码过滤只对已经退出的容器有意义,常用于快速寻找异常结束的任务。

bash
docker ps -a \
  --filter 'status=exited' \
  --filter 'exited=1' \
  --format 'table {{.Names}}\t{{.Status}}\t{{.Image}}'

预期输出

text
NAMES        STATUS                  IMAGE
data-job     Exited (1) <TIME> ago   <IMAGE>

退出码 0 通常表示程序正常结束,非 0 表示程序或启动命令返回了异常结果。筛选到目标后,可继续使用 docker logs <CONTAINER> 查看日志。

选择需要的输出字段

默认列表适合人工浏览,脚本处理则更适合 --format。常用字段包括 {{.ID}}、{{.Names}}、{{.Image}}、{{.Status}}、{{.Ports}} 和 {{.Labels}}。不要在脚本中依赖默认列宽或空格位置,因为不同终端下的展示可能变化。

bash
docker ps -a --format '{{.Names}}|{{.Status}}|{{.Ports}}'

预期输出

text
api-server|Up <TIME>|0.0.0.0:<PORT>->8080/tcp
data-job|Exited (1) <TIME> ago|

竖线分隔便于后续交给 awk、日志采集程序或其他脚本解析。

本课总结

  • docker ps 查看运行中容器,docker ps -a 查看全部容器
  • --filter 可按名称、标签、状态和退出码组合筛选
  • --format 能稳定输出脚本真正需要的字段

下一课预告

下一课将控制容器的启动、优雅停止、重启与强制终止,并说明不同命令对容器进程的影响。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

查看容器列表

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通