名称¶
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": ""
}
]
另请参阅¶
历史¶
2017年7月,由 Urvashi Mohnani umohnani@redhat.com 最初编写