名称¶
podman-ps - 打印有关容器的信息
概要¶
podman ps [选项]
podman container ps [选项]
podman container list [选项]
podman container ls [选项]
描述¶
podman ps 列出系统上正在运行的容器。使用 --all 标志查看所有容器的信息。默认情况下，它列出
容器 ID
容器正在使用的镜像名称
容器正在执行的命令
容器创建的时间
容器的状态
容器正在使用的端口映射
容器的替代名称
选项¶
--all, -a¶
显示所有容器，默认情况下仅显示正在运行的容器。
注意：Podman 与 Buildah 和 CRI-O 等其他工具共享容器存储。在某些情况下，这些 外部 容器可能也存在于同一个存储中。使用 --external 选项查看这些外部容器。外部容器显示‘存储’状态。
--external¶
显示不受 Podman 控制但存储在容器存储中的外部容器。这些外部容器通常通过其他容器技术（如 Buildah 或 CRI-O）创建，并且可能依赖于 Podman 也正在使用的相同容器镜像。外部容器在 ps 输出的 COMMAND 和 STATUS 列中用‘buildah’或‘storage’表示。
--filter, -f¶
过滤输出中显示的容器。可以使用多次使用 --filter 标志来给出多个过滤器。具有相同键的过滤器在包含性上起作用，唯一例外是 label，它是排他性的。具有不同键的过滤器总是排他性地起作用。
有效的过滤器列在下面
过滤器 |
描述 |
|---|---|
id |
[ID] 容器的 ID（默认情况下匹配 CID 前缀；接受正则表达式） |
name |
[名称] 容器的名称（接受正则表达式） |
label |
[键] 或 [键=值] 分配给容器的标签 |
label! |
[键] 或 [键=值] 未分配给容器的标签 |
exited |
[整数] 容器的退出代码 |
status |
[状态] 容器的状态：‘created’，‘exited’，‘paused’，‘running’，‘unknown’ |
ancestor |
[镜像名称] 用于创建容器的镜像或后代（接受正则表达式） |
before |
[ID] 或 [名称] 在此容器之前创建的容器 |
since |
[ID] 或 [名称] 自此容器创建以来的容器 |
volume |
[卷名称] 或 [挂载点目标] 挂载到容器中的卷 |
health |
[状态] 健康或不健康 |
pod |
[Pod] pod 的名称或完整或部分 ID |
network |
[网络] 网络的名称或完整 ID |
until |
[日期时间] 在给定持续时间或时间之前创建的容器。 |
--format=格式¶
以 JSON 或使用 Go 模板格式打印容器
Go 模板的有效占位符列在下面
占位符 |
描述 |
|---|---|
.AutoRemove |
如果为 true，则容器在退出时被删除 |
.CIDFile |
容器 ID 文件 |
.Command |
使用的带引号的命令 |
.Created … |
容器的创建时间，Y-M-D H:M:S |
.CreatedAt |
容器的创建时间（与上面相同） |
.CreatedHuman |
创建时间，相对 |
.ExitCode |
容器退出代码 |
.Exited |
如果容器已退出，则为“true” |
.ExitedAt |
容器退出时的（纪元秒）时间 |
.ExposedPorts … |
此容器上公开端口的映射 |
.ID |
容器 ID |
.Image |
镜像名称/ID |
.ImageID |
镜像 ID |
.IsInfra |
如果为基础设施容器，则为“true” |
.Label 字符串 |
容器的指定标签 |
.Labels … |
分配给容器的所有标签 |
.Mounts |
挂载到容器中的卷 |
.Names |
容器的名称 |
.Networks |
显示连接到容器的所有网络 |
.Pid |
主机系统上的进程 ID |
.Pod |
容器关联到的 pod（SHA） |
.PodName |
容器的 PodName |
.Ports |
转发的和公开的端口 |
.Restarts |
显示容器重启计数 |
.RunningFor |
容器启动后经过的时间 |
.Size |
容器的大小 |
.StartedAt |
容器启动时的（纪元秒）时间 |
.State |
ctr 状态的人类友好描述 |
.Status |
容器的状态 |
--help, -h¶
打印用法说明
--last, -n¶
打印最近创建的 n 个容器（所有状态）
--latest, -l¶
显示最近创建的容器（所有状态）（此选项在远程 Podman 客户端上不可用，包括 Mac 和 Windows（不包括 WSL2）机器）
--namespace, --ns¶
显示命名空间信息
--no-trunc¶
不要截断输出（默认值为 false）。
--noheading¶
从容器列表中省略表格标题。
--pod, -p¶
显示容器关联到的 pod
--quiet, -q¶
仅打印容器的数字 ID
--size, -s¶
显示总文件大小
--sort=created¶
按命令、创建、id、镜像、名称、运行时间、大小或状态排序”，注意：选择大小按 rootFs 的大小排序，而不是按字母顺序排序，就像其他选项一样
--sync¶
强制将容器状态与 OCI 运行时同步。在某些情况下，运行时中的容器状态可能与 Podman 的状态不同步。这会根据 OCI 运行时报告的內容更新 Podman 的状态。强制同步要慢得多，但可以解决状态不一致的问题。
--watch, -w¶
以秒为单位的间隔刷新当前容器的输出。
示例¶
列出正在运行的容器。
$ podman ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
4089df24d4f3 docker.io/library/centos:latest /bin/bash 2 minutes ago Up 2 minutes 0.0.0.0:80->8080/tcp, 0.0.0.0:2000-2006->2000-2006/tcp manyports
92f58933c28c docker.io/library/centos:latest /bin/bash 3 minutes ago Up 3 minutes 192.168.99.100:1000-1006->1000-1006/tcp zen_sanderson
列出所有容器。
$ podman ps -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
02f65160e14ca redis:alpine "redis-server" 19 hours ago Exited (-1) 19 hours ago 6379/tcp k8s_podsandbox1-redis_podsandbox1_redhat.test.crio_redhat-test-crio_0
69ed779d8ef9f redis:alpine "redis-server" 25 hours ago Created 6379/tcp k8s_container1_podsandbox1_redhat.test.crio_redhat-test-crio_1
列出所有容器，包括其大小。注意：这可能需要更长的时间，因为 Podman 需要从文件系统计算大小。
$ podman ps -a -s
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES SIZE
02f65160e14ca redis:alpine "redis-server" 20 hours ago Exited (-1) 20 hours ago 6379/tcp k8s_podsandbox1-redis_podsandbox1_redhat.test.crio_redhat-test-crio_0 27.49 MB
69ed779d8ef9f redis:alpine "redis-server" 25 hours ago Created 6379/tcp k8s_container1_podsandbox1_redhat.test.crio_redhat-test-crio_1 27.49 MB
列出所有容器，正在运行或未运行，使用自定义 Go 格式。
$ podman ps -a --format "{{.ID}} {{.Image}} {{.Labels}} {{.Mounts}}"
02f65160e14ca redis:alpine tier=backend proc,tmpfs,devpts,shm,mqueue,sysfs,cgroup,/var/run/,/var/run/
69ed779d8ef9f redis:alpine batch=no,type=small proc,tmpfs,devpts,shm,mqueue,sysfs,cgroup,/var/run/,/var/run/
列出所有容器并显示其命名空间。
$ podman ps --ns -a
CONTAINER ID NAMES PID CGROUP IPC MNT NET PIDNS USER UTS
3557d882a82e3 k8s_container2_podsandbox1_redhat.test.crio_redhat-test-crio_1 29910 4026531835 4026532585 4026532593 4026532508 4026532595 4026531837 4026532594
09564cdae0bec k8s_container1_podsandbox1_redhat.test.crio_redhat-test-crio_1 29851 4026531835 4026532585 4026532590 4026532508 4026532592 4026531837 4026532591
a31ebbee9cee7 k8s_podsandbox1-redis_podsandbox1_redhat.test.crio_redhat-test-crio_0 29717 4026531835 4026532585 4026532587 4026532508 4026532589 4026531837 4026532588
列出所有容器，包括按名称排序的大小。
$ podman ps -a --size --sort names
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
69ed779d8ef9f redis:alpine "redis-server" 25 hours ago Created 6379/tcp k8s_container1_podsandbox1_redhat.test.crio_redhat-test-crio_1
02f65160e14ca redis:alpine "redis-server" 19 hours ago Exited (-1) 19 hours ago 6379/tcp k8s_podsandbox1-redis_podsandbox1_redhat.test.crio_redhat-test-crio_0
列出除 Podman 外的其他工具创建的所有外部容器。
$ podman ps --external -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
69ed779d8ef9f redis:alpine "redis-server" 25 hours ago Created 6379/tcp k8s_container1_podsandbox1_redhat.test.crio_redhat-test-crio_1
38a8a78596f9 docker.io/library/busybox:latest buildah 2 hours ago storage busybox-working-container
fd7b786b5c32 docker.io/library/alpine:latest buildah 2 hours ago storage alpine-working-container
f78620804e00 scratch buildah 2 hours ago storage working-container
ps¶
打印容器列表
另请参见¶
历史¶
2017 年 8 月，最初由 Urvashi Mohnani 编译 umohnani@redhat.com