docker ps 语法
docker ps 语法
语法:docker ps [OPTIONS]
参数:
参数名 |
参数描述 |
–all, -a |
显示所有的容器,包括未运行的 |
–filter, -f |
根据条件过滤显示的内容 |
–format: |
指定返回值的模板文件 |
–last, -l |
显示最近创建的容器 |
–latest, -n |
列出最近创建的n个容器 |
–no-trunc |
不截断输出 |
–quiet, -q |
静默模式,只显示容器编号 |
–size, -s |
显示总的文件大小 |
语义:根据指定参数显示容器列表。
docker ps -a 示例
列表项说明:
列名 |
列描述 |
CONTAINER ID |
容器ID |
IMAGE |
容器使用的镜像 |
COMMAND |
启动容器时运行的命令 |
CREATED |
容器的创建时间 |
STATUS |
容器状态(共七种:created(已创建)、restarting(重启中)、running(运行中)、removing(迁移中)、paused(暂停)、exited(停止)、dead(死亡)) |
PORTS |
容器的端口信息和使用的连接类型 |
NAMES |
自动分配或指定的容器名称 |
docker ps -f 示例
-f 可用参数说明:
过滤条件 |
过滤条件描述 |
id |
容器ID |
name |
容器名称 |
label |
表示键或键值对的任意字符串 |
exited |
容器退出的整数代码,仅与–all, -a一起使用 |
status |
容器状态:created、restarting、running、removing、paused、exited、dead |
ancestor |
给定镜像作为祖先共享的容器,[:]、、image@digest |
bofore/since |
在给定容器ID或名称之前或之后创建的容器 |
volume |
筛选器运行已装入给定卷或绑定装入的容器 |
network |
运行连接到给定网络的容器 |
publish/expose |
发布或公开筛选器的给定端口,[/]、/[] |
health |
容器的运行状况检查状态:starting、healthy、unhealthy、none |
isolation |
仅限Window守护进程 |
is-task |
过滤作为服务"task"的容器,布尔选项(true或false) |
条件规则:
1.-f后跟的是键值对key=value,如果有多个条件,就多次使用-f:
2.相同条件之间关系是或,不同条年之间关系是与:
3.id和name支持模糊匹配和正则表达式:
docker ps --format 示例
--format参数可以用来规范输出的容器列表内容格式,一般在使用工具进行维护时,是非常有用的。
--format 可用参数说明:
替换参数 |
替换参数描述 |
.ID |
容器ID |
.Image |
镜像ID |
.Command |
应用命令 |
.CreatedAt |
容器的创建时间 |
.RunningFor |
容器已运行时间 |
.Ports |
开放的端口 |
.Status |
容器状态 |
.Size |
容器磁盘大小 |
.Names |
容器名称 |
.Labels |
分配给容器的所有标签 |
.Label |
此容器的特定标签的值,如:’{{.Label “com.docker.swarm.cpu”}}’ |
.Mounts |
此容器中装入的卷的名称 |
.Networks |
附加到此容器的网络的名称 |
docker ps -l 示例
docker ps -n 示例
-n紧跟的参数表示需要查看的容器的数量。
docker ps --no-trunc 示例
docker ps -s 示例