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