查看 docker 容器,必然要用到 docker ps 命令。其基本格式为:

docker ps [OPTIONS]

关键在于 OPTIONS(选项):

docker ps 完整 docker ps -all_运维

1

常见用法

1. 最常见的用法

$ docker ps

显示当前正在运行的容器。

在 PORTS 一列,如果暴露的端口是连续的,还会被合并在一起,例如一个容器暴露了3个 TCP 端口:100,101,102,则会显示为 100-102/tcp。

2. 显示所有状态的容器

$ docker ps -a

容器的状态共有 7 种:created|restarting|running|removing|paused|exited|dead。

3. 显示最后被创建的 n 个容器

$ docker ps -n 3

注意,这里不限状态。

4. 显示最后被创建的容器

$ docker ps -l

相当于 docker ps -n 1。

5. 显示完整输出

$ docker ps --no-trunc

即不会截断输出。该选项有点长,其中 trunc 算是 truncate 的缩写。

6. 只显示容器 ID

$ docker ps -q

清理容器时非常好用,filter 过滤显示一节有具体实例。

7. 显示容器文件大小

$ docker ps -s

该命令很实用,可以获得 2 个数值:一个是容器真实增加的大小,一个是整个容器的虚拟大小。

查看源码(https://github.com/moby/moby/blob/master/daemon/getsize_unix.go)后可知,容器虚拟大小 = 容器真实增加大小 + 容器镜像大小。

2

高级用法

Filter 过滤显示

如果容器数量过多,或者想排除干扰容器,可以通过 --filter 或 -f 选项,过滤需要显示的容器。

当前支持的过滤条件非常丰富,包括:

docker ps 完整 docker ps -all_docker ps 完整_02

条件虽多,但万变不离其宗,只要再记住以下 3 条准则:

1. 选项后跟的都是键值对 key=value (可不带引号),如果有多个过滤条件,就多次使用 filter 选项。例如:

docker ps --filter id=a1b2c3 --filter name=bingohuang

2. 相同条件之间的关系是或,不同条件之间的关系是与。例如:

docker ps --filter name=bingo --filter name=huang --filter status=running

以上过滤条件会找出 name 包含 bingo 或 huang 并且 status 为 running 的容器。

3. id 和 name,支持正则表达式,使用起来非常灵活。例如:

docker ps --filter name=^/bingohuang$

精确匹配 name 为 bingohuang 的容器。注意,容器实际名称,开头是有一个正斜线 / ,可用 docker inspect 一看便知。

docker ps --filter name=.*bingohuang.*

匹配 name 包含 bingohuang 的容器,和 --filter name=bingohuang 一个效果。

最后, 举一个复杂点的例子,用于清理名称包含 bingohuang,且状态为 exited 或 dead 的容器:

docker rm $(docker ps -q --filter name=.*bingohuang.* --filter status=exited --filter status=dead2>/dev/null)

Format 格式化显示

如果想自定义显示容器字段,可以用格式化选项 --format 。

基于 Go template(https://golang.org/pkg/html/template/)语法,可用的占位符如下:

docker ps 完整 docker ps -all_运维_03

1. 当使用了 --format 选项,那么 ps 命令只会输出 template 中指定的内容:

$ docker ps --format "{{.ID}}: {{.Command}}"

a87ecb4f327c: /bin/sh -c #(nop) MA

01946d9d34d8: /bin/sh -c #(nop) MA

c1d3b0166030: /bin/sh -c yum -y up

41d50ecd2f57:/bin/sh -c #(nop) MA

2. 如果想带上表格列头,需要再 template 中加上 table 指令:

docker ps 完整 docker ps -all_golang_04