容器与云原生 / 系统课时
查看容器列表
查看容器列表
本课解决“当前有哪些容器、它们处于什么状态”这一常见问题。你将掌握 docker ps 与 docker ps -a 的区别,并能按名称、状态、标签和退出码快速筛选目标容器。
学习目标
- 区分运行中容器与全部容器列表
- 使用常用过滤条件缩小查询范围
- 自定义输出字段,快速定位状态异常
查看运行中与全部容器
docker ps 默认只显示正在运行的容器;docker ps -a 会同时显示已创建、运行中、已退出等全部容器。docker container ls 与 docker ps 等价,前者更符合 Docker 的分组命令风格。
下面用格式化输出避免默认表格过宽。时间、容器 ID 和状态持续时间会随实际环境变化。
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}}'预期输出
=== 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。
docker ps -a \
--filter 'name=api' \
--filter 'label=env=test' \
--format 'table {{.Names}}\t{{.Image}}\t{{.Labels}}'预期输出
NAMES IMAGE LABELS
api-server <IMAGE> env=test,<OTHER_LABELS>查询不到结果时,先分别删除一个过滤条件运行,确认是名称不匹配,还是容器没有对应标签。
按状态和退出码筛选
状态过滤适合查找 running、exited、created、paused 等容器。退出码过滤只对已经退出的容器有意义,常用于快速寻找异常结束的任务。
docker ps -a \
--filter 'status=exited' \
--filter 'exited=1' \
--format 'table {{.Names}}\t{{.Status}}\t{{.Image}}'预期输出
NAMES STATUS IMAGE
data-job Exited (1) <TIME> ago <IMAGE>退出码 0 通常表示程序正常结束,非 0 表示程序或启动命令返回了异常结果。筛选到目标后,可继续使用 docker logs <CONTAINER> 查看日志。
选择需要的输出字段
默认列表适合人工浏览,脚本处理则更适合 --format。常用字段包括 {{.ID}}、{{.Names}}、{{.Image}}、{{.Status}}、{{.Ports}} 和 {{.Labels}}。不要在脚本中依赖默认列宽或空格位置,因为不同终端下的展示可能变化。
docker ps -a --format '{{.Names}}|{{.Status}}|{{.Ports}}'预期输出
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能稳定输出脚本真正需要的字段
下一课预告
下一课将控制容器的启动、优雅停止、重启与强制终止,并说明不同命令对容器进程的影响。