显示镜像的历史记录

摘要

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

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

描述

podman history 通过打印镜像中每层的信息来显示镜像的历史记录。对于每一层，打印的信息包括创建时间（日期和时间）、创建者、大小和注释。 使用 --no-trunc 标志可以控制输出是否截断。如果设置了 --human 标志，则创建时间和大小将以人类可读的格式打印出来。 当设置 --quiet 标志时，仅显示镜像的ID。--format 标志用于使用用户提供的Go模板打印信息。

选项

--format=格式

以像 'json' 这样的格式或Go模板来修改输出。

Go模板中有效的占位符列举如下：

占位符	描述
.Comment	层的注释
.Created	如果设置了 --human，则为自创建以来的时间，否则为创建的时间戳
.CreatedAt	镜像层创建的时间
.CreatedBy	创建该层时使用的命令
.CreatedSince	自镜像层创建以来的经过时间
.ID	镜像ID
.Size	层在磁盘上的大小
.Tags	镜像标签

示例

1.显示名为 myimage 的镜像的历史记录：

podman history myimage

2.以JSON格式显示名为 myimage:latest 的镜像的历史记录：

podman history --format json myimage:latest

3.使用Go模板自定义输出，仅显示镜像ID和创建时间：

podman history --format "{{.ID}}\t{{.CreatedAt}}" myimage

--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

在这个例子中，我们使用了 --format 选项来定制输出格式。Go模板 {{.ID}} {{.Created}} 告诉 podman 只显示镜像的ID和创建时间。注意，如果镜像层没有创建时间（如某些基础层），则可能显示为 <missing>。

以下是对给定示例的中文解释：

以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": ""
    }
]

输出是一个JSON数组，数组中的每个元素代表镜像的一层。每个元素都是一个对象，包含以下字段：

• id: 镜像层的唯一标识符。
• created: 镜像层创建的时间戳。
• createdBy: 创建该镜像层时执行的命令。
• size: 镜像层的大小。
• comment: 镜像层的注释，通常为空。

这个命令允许你以结构化的方式获取镜像的历史记录，这对于脚本处理或进一步分析镜像的组成非常有用。

另请参阅

podman(1)，podman-image(1)

这是podman命令的手册页，其中包含了podman的所有可用选项和子命令的详细信息。

历史

2017年7月，最初由Urvashi Mohnani整理编译。

这个“历史”部分提供了关于该命令或文档最初编写和整理者的信息，以及可能的初始发布日期。