1podman-history(1)() podman-history(1)()
2
6 podman-history - Show the history of an image
7
10 podman history [options] image[:tag|@digest]
11 podman image history [options] image[:tag|@digest]
14
17 podman history displays the history of an image by printing out infor‐
18 mation about each layer used in the image. The information printed out
19 for each layer include Created (time and date), Created By, Size, and
20 Comment. The output can be truncated or not using the --no-trunc flag.
21 If the --human flag is set, the time of creation and size are printed
22 out in a human readable format. The --quiet flag displays the ID of
23 the image only when set and the --format flag is used to print the
24 information using the Go template provided by the user.
25 Valid placeholders for the Go template are listed below:
28 ┌────────────────────────────────────────────────────────────────┬────────────────────────────┐
31 │Placeholder │ Description │
32 ├────────────────────────────────────────────────────────────────┼────────────────────────────┤
33 │.ID │ Image ID │
34 ├────────────────────────────────────────────────────────────────┼────────────────────────────┤
35 │.Created │ if │
36 ├────────────────────────────────────────────────────────────────┼────────────────────────────┤
37 │--humanT{ │ │
38 ├────────────────────────────────────────────────────────────────┼────────────────────────────┤
39 │, time elapsed since creation, otherwise time stamp of creation │ │
40 ├────────────────────────────────────────────────────────────────┼────────────────────────────┤
41 │T} │ │
42 ├────────────────────────────────────────────────────────────────┼────────────────────────────┤
43 │.CreatedBy │ Command used to create the │
44 │ │ layer │
45 ├────────────────────────────────────────────────────────────────┼────────────────────────────┤
46 │.Size │ Size of layer on disk │
47 ├────────────────────────────────────────────────────────────────┼────────────────────────────┤
48 │.Comment │ Comment for the layer │
49 └────────────────────────────────────────────────────────────────┴────────────────────────────┘
50
52 --human, -H
53 Display sizes and dates in human readable format
56 --no-trunc
59 Do not truncate the output
62 --quiet, -q
65 Print the numeric IDs only
68 --format=format
71 Alter the output for a format like 'json' or a Go template.
74 --help, -h
77 Print usage statement
80
83 $ podman history debian
84 ID CREATED CREATED BY SIZE COMMENT
85 b676ca55e4f2c 9 weeks ago /bin/sh -c #(nop) CMD ["bash"] 0 B
86 <missing> 9 weeks ago /bin/sh -c #(nop) ADD file:ebba725fb97cea4... 45.14 MB
87 $ podman history --no-trunc=true --human=false debian
91 ID CREATED CREATED BY SIZE COMMENT
92 b676ca55e4f2c 2017-07-24T16:52:55Z /bin/sh -c #(nop) CMD ["bash"] 0
93 <missing> 2017-07-24T16:52:54Z /bin/sh -c #(nop) ADD file:ebba725fb97cea4... 45142935
94 $ podman history --format "{{.ID}} {{.Created}}" debian
98 b676ca55e4f2c 9 weeks ago
99 <missing> 9 weeks ago
100 $ podman history --format json debian
104 [
105 {
106 "id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
107 "created": "2017-07-24T16:52:55.195062314Z",
108 "createdBy": "/bin/sh -c #(nop) CMD [\"bash\"]",
109 "size": 0,
110 "comment": ""
111 },
112 {
113 "id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
114 "created": "2017-07-24T16:52:54.898893387Z",
115 "createdBy": "/bin/sh -c #(nop) ADD file:ebba725fb97cea45d0b1b35ccc8144e766fcfc9a78530465c23b0c4674b14042 in / ",
116 "size": 45142935,
117 "comment": ""
118 }
119 ]
120
124 podman(1)
125
128 July 2017, Originally compiled by Urvashi Mohnani umohnani@redhat.com
129 ⟨mailto:umohnani@redhat.com⟩
130 podman-history(1)()