名称¶
podman-images - 列出本地存储中的镜像
概要¶
podman images [选项] [镜像]
podman image list [选项] [镜像]
podman image ls [选项] [镜像]
描述¶
显示本地存储的镜像，其名称和 ID。
选项¶
--all, -a¶
显示所有镜像（默认情况下过滤掉中间镜像层）。默认值为 false。
--digests¶
显示镜像摘要
--filter, -f=filter¶
提供筛选器值。
筛选器参数格式为 key=value 或 key!=value。如果有多个筛选器，则传递多个选项：--filter foo=bar --filter bif=baz。
支持的筛选器
筛选器 |
描述 |
|---|---|
id |
按镜像 ID 筛选。 |
before |
按在给定镜像（名称或标签）之前创建的镜像筛选。 |
containers |
按具有正在运行容器的镜像筛选。 |
dangling |
按悬空（未使用）镜像筛选。 |
digest |
按摘要筛选。 |
intermediate |
按悬空且没有子节点的镜像筛选 |
label |
按具有（或没有，在使用 label!=[…] 的情况下）指定标签的镜像筛选。 |
manifest |
按是清单列表的镜像筛选。 |
readonly |
按只读或读/写镜像筛选。 |
reference |
按镜像名称筛选。 |
after/since |
按在给定镜像（名称或标签）之后创建的镜像筛选。 |
until |
按在给定持续时间或时间之前创建的镜像筛选。 |
id 筛选器接受镜像 ID 字符串。
before 筛选器接受格式：<image-name>[:<tag>]、<image id> 或 <image@digest>。
containers 筛选器显示基于该镜像具有正在运行容器的镜像。
dangling 筛选器显示占用磁盘空间且没有用处的镜像。悬空镜像是以前镜像构建中使用过的文件系统层，不再被任何镜像引用。它们用 <none> 标签表示，占用磁盘空间且没有实际用途。
digest 筛选器接受镜像摘要字符串。
intermediate 筛选器显示悬空且没有子节点的镜像。
label 筛选器接受两种格式。一种是 label=key 或 label=key=value，显示具有指定标签的镜像。另一种格式是 label!=key 或 label!=key=value，显示没有指定标签的镜像。
manifest 筛选器显示是清单列表的镜像。
readonly 筛选器默认情况下显示只读和读/写镜像。只读镜像可以通过修改 /etc/containers/storage.conf 文件中的 additionalimagestores 来配置。
reference 筛选器接受镜像引用模式 <image-name>[:<tag>]。
after 或 since 筛选器接受格式：<image-name>[:<tag>]、<image id> 或 <image@digest>。
until 筛选器接受格式：golang 持续时间、RFC3339 时间或 Unix 时间戳，并显示在该时间之前创建的所有镜像。
--format=format¶
更改默认输出格式。这可以是支持的类型（例如 ‘json’）或 Go 模板。Go 模板的有效占位符列在下面
占位符 |
描述 |
|---|---|
.Containers |
使用此镜像的容器数量 |
.Created |
镜像创建以来的经过时间 |
.CreatedAt |
镜像创建时间，YYYY-MM-DD HH:MM:SS +nnnn |
.CreatedSince |
与 .Created 相同 |
.CreatedTime |
与 .CreatedAt 相同 |
.Dangling |
与 .IsDangling 相同 |
.Digest |
镜像摘要 |
.History |
镜像层的历史记录 |
.ID |
镜像 ID（已截断） |
.Id |
镜像 ID（完整 SHA） |
.IsDangling |
镜像是否悬空？（true/false） |
.IsReadOnly |
镜像是否为只读？（true/false） |
.Labels … |
标签的 map[] |
.Names |
镜像 FQIN |
.ParentId |
父镜像 ID 的完整 SHA，或 null（字符串） |
.ReadOnly |
与 .IsReadOnly 相同 |
.RepoDigests |
零个或多个 repo/name@sha256:SHA 字符串的 map[] |
.Repository |
镜像存储库 |
.RepoTags |
此镜像的零个或多个 FQIN 字符串的 map[] |
.SharedSize |
始终为 0 |
.Size |
磁盘上层的尺寸（人类可读的字符串） |
.Tag |
镜像标签 |
.VirtualSize |
磁盘上层的尺寸（字节） |
--history¶
显示镜像名称的历史记录。如果镜像被重新标记或取消标记，则镜像名称历史记录会被添加在前面（最新的镜像位于第一位）。这在撤消标记操作或镜像不包含任何名称（因为它已被取消标记）时特别有用。
--no-trunc¶
不截断输出（默认值为 false）。
--noheading, -n¶
从列表中省略表标题。
--quiet, -q¶
仅列出镜像 ID。
--sort=sort¶
按 created、id、repository、size 或 tag 排序（默认值：created）按 repository 排序时，还按 tag 作为第二个标准进行排序以提供稳定的输出。
示例¶
列出本地存储中所有非悬空镜像
$ podman images
REPOSITORY TAG IMAGE ID CREATED SIZE
quay.io/podman/stable latest e0b7dabc3352 22 hours ago 331 MB
docker.io/library/alpine latest 9c6f07244728 5 days ago 5.83 MB
registry.fedoraproject.org/fedora latest 2ecb6df95994 3 weeks ago 169 MB
quay.io/libpod/testimage 20220615 f26aa69bb3f3 2 months ago 8.4 MB
列出与指定名称匹配的所有镜像
$ podman images stable
REPOSITORY TAG IMAGE ID CREATED SIZE
quay.io/podman/stable latest e0b7dabc3352 22 hours ago 331 MB
列出容器存储中所有镜像的镜像 ID
# podman image ls --quiet
e3d42bcaf643
ebb91b73692b
4526339ae51c
列出所有镜像，不显示标题
# podman images --noheading
docker.io/kubernetes/pause latest e3d42bcaf643 3 years ago 251 kB
<none> <none> ebb91b73692b 4 weeks ago 27.2 MB
docker.io/library/ubuntu latest 4526339ae51c 6 weeks ago 126 MB
列出所有镜像，不截断输出
# podman image list --no-trunc
REPOSITORY TAG IMAGE ID CREATED SIZE
docker.io/kubernetes/pause latest sha256:e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27 3 years ago 251 kB
<none> <none> sha256:ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9 4 weeks ago 27.2 MB
docker.io/library/ubuntu latest sha256:4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a 6 weeks ago 126 MB
使用格式化的内容列出所有镜像内容
# podman images --format "table {{.ID}} {{.Repository}} {{.Tag}}"
IMAGE ID REPOSITORY TAG
e3d42bcaf643 docker.io/kubernetes/pause latest
ebb91b73692b <none> <none>
4526339ae51c docker.io/library/ubuntu latest
列出任何没有标记名称（悬空）的镜像
# podman images --filter dangling=true
REPOSITORY TAG IMAGE ID CREATED SIZE
<none> <none> ebb91b73692b 4 weeks ago 27.2 MB
以 JSON 格式列出所有镜像
# podman images --format json
[
{
"id": "e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27",
"names": [
"docker.io/kubernetes/pause:latest"
],
"digest": "sha256:0aecf73ff86844324847883f2e916d3f6984c5fae3c2f23e91d66f549fe7d423",
"created": "2014-07-19T07:02:32.267701596Z",
"size": 250665
},
{
"id": "ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9",
"names": [
"\u003cnone\u003e"
],
"digest": "sha256:ba7e4091d27e8114a205003ca6a768905c3395d961624a2c78873d9526461032",
"created": "2017-10-26T03:07:22.796184288Z",
"size": 27170520
},
{
"id": "4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a",
"names": [
"docker.io/library/ubuntu:latest"
],
"digest": "sha256:193f7734ddd68e0fb24ba9af8c2b673aecb0227b026871f8e932dab45add7753",
"created": "2017-10-10T20:59:05.10196344Z",
"size": 126085200
}
]
按指定的列列出所有镜像
# podman images --sort repository
REPOSITORY TAG IMAGE ID CREATED SIZE
<none> <none> 2460217d76fc About a minute ago 4.41 MB
docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB
localhost/myapp latest b2e0ad03474a About a minute ago 4.41 MB
registry.access.redhat.com/rhel7 latest 7a840db7f020 2 weeks ago 211 MB
registry.fedoraproject.org/fedora 27 801894bc0e43 6 weeks ago 246 MB
显示正在使用的列出镜像与所有镜像（包括悬空镜像）之间的差异
# podman images
REPOSITORY TAG IMAGE ID CREATED SIZE
localhost/test latest 18f0c080cd72 4 seconds ago 4.42 MB
docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB
# podman images -a
REPOSITORY TAG IMAGE ID CREATED SIZE
localhost/test latest 18f0c080cd72 6 seconds ago 4.42 MB
<none> <none> 270e70dc54c0 7 seconds ago 4.42 MB
<none> <none> 4ed6fbe43414 8 seconds ago 4.41 MB
<none> <none> 6b0df8e71508 8 seconds ago 4.41 MB
docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB
另请参阅¶
podman(1), containers-storage.conf(5)
疑难解答¶
有关常见问题的解决方案，请参阅 podman-troubleshooting(7)。
历史¶
2017 年 3 月，最初由 Dan Walsh 编译 <dwalsh@redhat.com>