名称

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

简介

podman history [选项] image[:tag|@digest]

podman image history [选项] image[:tag|@digest]

描述

podman history 通过打印出镜像中每个层的相关信息来显示镜像的历史记录。为每个层打印出的信息包括 Created(创建时间和日期)、Created By(创建者命令)、Size(大小)和 Comment(注释)。可以使用 --no-trunc 标志来决定是否截断输出。如果设置了 --human 标志,创建时间和大小将以人类可读的格式打印。设置 --quiet 标志时仅显示镜像的 ID,而 --format 标志用于使用用户提供的 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 最初编写