名称¶
podman-images - 列出本地存储中的镜像
简介¶
podman images [选项] [镜像]
podman image list [选项] [镜像]
podman image ls [选项] [镜像]
描述¶
显示本地存储的镜像、它们的名称和 ID。
选项¶
--all, -a¶
显示所有镜像（默认情况下，过滤掉中间镜像层）。默认值为 false。
--digests¶
显示镜像摘要
--filter, -f=过滤器¶
提供过滤值。
filters 参数的格式为 key=value 或 key!=value。如果有多个 filter，则传递多个 OPTIONS：--filter foo=bar --filter bif=baz。
支持的过滤器
过滤器 |
描述 |
|---|---|
id |
按镜像 ID 过滤。 |
before |
按给定镜像（名称或标签）之前创建的镜像进行过滤。 |
容器 |
按具有正在运行的容器的镜像进行过滤。 |
悬空 |
按悬空（未使用）镜像进行过滤。 |
摘要 |
按摘要过滤。 |
中间 |
按悬空且没有子级的镜像进行过滤 |
label |
按具有（或没有，在使用 label!=[…] 的情况下）指定标签的镜像进行过滤。 |
清单 |
按清单列表镜像进行过滤。 |
只读 |
按只读或读/写镜像进行过滤。 |
引用 |
按镜像名称过滤。 |
之后/以来 |
按给定镜像（名称或标签）之后创建的镜像进行过滤。 |
until |
按给定持续时间或时间之前创建的镜像进行过滤。 |
id filter 接受镜像 ID 字符串。
before filter 接受以下格式：<image-name>[:<tag>]、<image id> 或 <image@digest>。
containers filter 显示基于该镜像的正在运行的容器的镜像。
dangling filter 显示占用磁盘空间但无用的镜像。悬空镜像是在镜像的先前构建中使用的文件系统层，不再被任何镜像引用。它们以 <none> 标签表示，占用磁盘空间且没有任何活动用途。
digest filter 接受镜像摘要字符串。
intermediate filter 显示悬空且没有子级的镜像。
label filter 接受两种格式。一种是 label=key 或 label=key=value，显示具有指定标签的镜像。另一种格式是 label!=key 或 label!=key=value，显示没有指定标签的镜像。
manifest filter 显示清单列表镜像。
readonly filter 默认显示只读和读/写镜像。可以通过修改 /etc/containers/storage.conf 文件中的 additionalimagestores 来配置只读镜像。
reference filter 接受镜像引用 <image-name>[:<tag>] 的模式。
after 或 since filter 接受以下格式：<image-name>[:<tag>]、<image id> 或 <image@digest>。
until filter 接受以下格式：golang 持续时间、RFC3339 时间或 Unix 时间戳，并显示在该时间之前创建的所有镜像。
--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 (string) |
.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> 编译