3a9d14d4e9
Followup to #17486: stricter checks on --format. * If a subcommand offers autocompletion for templates, it must also offer a '--format json' option. * If a subcommand has a --format option that DOES NOT offer autocompletion for templates, it must be listed in a hardcoded grandparented-in table of commands where that's not applicable. (Mostly commands like build, commit, save, where "format" is used in the context of "oci/docker"). Only likely to trigger on PRs which add new subcommands, and is intended to catch oversights. Also, test for alphanumeric order in man page tables. Sort all existing tables. Signed-off-by: Ed Santiago <santiago@redhat.com>
3.6 KiB
% podman-history 1
NAME
podman-history - Show the history of an image
SYNOPSIS
podman history [options] image[:tag|@digest]
podman image history [options] image[:tag|@digest]
DESCRIPTION
podman history displays the history of an image by printing out information about each layer used in the image. The information printed out for each layer include Created (time and date), Created By, Size, and Comment. The output can be truncated or not using the --no-trunc flag. If the --human flag is set, the time of creation and size are printed out in a human readable format. The --quiet flag displays the ID of the image only when set and the --format flag is used to print the information using the Go template provided by the user.
OPTIONS
--format=format
Alter the output for a format like 'json' or a Go template.
Valid placeholders for the Go template are listed below:
| Placeholder | Description |
|---|---|
| .Comment | Comment for the layer |
| .Created | if --human, time elapsed since creation, otherwise time stamp of creation |
| .CreatedAt | Time when the image layer was created |
| .CreatedBy | Command used to create the layer |
| .CreatedSince | Elapsed time since the image layer was created |
| .ID | Image ID |
| .Size | Size of layer on disk |
| .Tags | Image tags |
--help, -h
Print usage statement
--human, -H
Display sizes and dates in human readable format (default true).
--no-trunc
Do not truncate the output (default false).
--quiet, -q
Print the numeric IDs only (default false).
EXAMPLES
$ 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
$ 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": ""
}
]
SEE ALSO
HISTORY
July 2017, Originally compiled by Urvashi Mohnani umohnani@redhat.com