名称

podman-history - 显示镜像的历史记录

概要

podman history [选项] 镜像[:标签|@摘要]

podman image history [选项] 镜像[:标签|@摘要]

描述

podman history 通过打印出镜像中使用的每个层的相关信息,来显示镜像的历史记录。每个层打印的信息包括创建时间(时间和日期)、创建者、大小和注释。使用--no-trunc 标志可以截断或不截断输出。如果设置了--human 标志,创建时间和大小将以人类可读的格式打印出来。如果设置了--quiet 标志,则仅在设置了该标志且使用了--format 标志时才显示镜像的 ID。使用用户提供的 Go 模板可以打印信息。

选项

--format=格式

更改输出以使用类似 'json' 的格式或 Go 模板。

Go 模板的有效占位符如下所示

占位符

描述

.Comment

层的注释

.Created

如果使用 --human,则显示自创建以来的时间,否则显示创建的时间戳

.CreatedAt

镜像层创建的时间

.CreatedBy

用于创建层的命令

.CreatedSince

自镜像层创建以来的经过时间

.ID

镜像 ID

.Size

层在磁盘上的大小

.Tags

镜像标签

--help, -h

打印使用说明

--human, -H

以人类可读的格式显示大小和日期(默认值为 true)。

--no-trunc

不截断输出(默认值为 false)。

--quiet, -q

仅打印数字 ID(默认值为 false)。

示例

显示指定镜像的历史记录

$ podman history debian
ID              CREATED       CREATED BY                                      SIZE       COMMENT
b676ca55e4f2c   9 weeks ago   /bin/sh -c #(nop) CMD ["bash"]                  0 B
<missing>       9 weeks ago   /bin/sh -c #(nop) ADD file:ebba725fb97cea4...   45.14 MB

显示指定镜像的历史记录,不截断内容并使用原始数据

$ podman history --no-trunc=true --human=false debian
ID              CREATED                CREATED BY                                      SIZE       COMMENT
b676ca55e4f2c   2017-07-24T16:52:55Z   /bin/sh -c #(nop) CMD ["bash"]                  0
<missing>       2017-07-24T16:52:54Z   /bin/sh -c #(nop) ADD file:ebba725fb97cea4...   45142935

显示指定镜像的格式化历史记录

$ podman history --format "{{.ID}} {{.Created}}" debian
b676ca55e4f2c   9 weeks ago
<missing>       9 weeks ago

以 JSON 格式显示指定镜像的历史记录

$ podman history --format json debian
[
    {
	"id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
	"created": "2017-07-24T16:52:55.195062314Z",
	"createdBy": "/bin/sh -c #(nop)  CMD [\"bash\"]",
	"size": 0,
	"comment": ""
    },
    {
	"id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
	"created": "2017-07-24T16:52:54.898893387Z",
	"createdBy": "/bin/sh -c #(nop) ADD file:ebba725fb97cea45d0b1b35ccc8144e766fcfc9a78530465c23b0c4674b14042 in / ",
	"size": 45142935,
	"comment": ""
    }
]

另请参阅

podman(1)

历史记录

2017 年 7 月,最初由 Urvashi Mohnani 编写 umohnani@redhat.com