1podman-history(1)() podman-history(1)()
2
3
4
6 podman-history - Show the history of an image
7
8
10 podman history [options] image[:tag|@digest]
11
12
13 podman image history [options] image[:tag|@digest]
14
15
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
26
27 Valid placeholders for the Go template are listed below:
28
29
30 ┌────────────┬────────────────────────────┐
31 │Placeholder │ Description │
32 ├────────────┼────────────────────────────┤
33 │.ID │ Image ID │
34 ├────────────┼────────────────────────────┤
35 │.Created │ if --human, time elapsed │
36 │ │ since creation, otherwise │
37 │ │ time stamp of creation │
38 ├────────────┼────────────────────────────┤
39 │.CreatedBy │ Command used to create the │
40 │ │ layer │
41 ├────────────┼────────────────────────────┤
42 │.Size │ Size of layer on disk │
43 ├────────────┼────────────────────────────┤
44 │.Comment │ Comment for the layer │
45 └────────────┴────────────────────────────┘
46
48 --human, -H=true|false
49
50
51 Display sizes and dates in human readable format (default true).
52
53
54 --no-trunc=true|false
55
56
57 Do not truncate the output (default false).
58
59
60 --quiet, -q=true|false
61
62
63 Print the numeric IDs only (default false).
64
65
66 --format=format
67
68
69 Alter the output for a format like 'json' or a Go template.
70
71
72 --help, -h
73
74
75 Print usage statement
76
77
79 $ podman history debian
80 ID CREATED CREATED BY SIZE COMMENT
81 b676ca55e4f2c 9 weeks ago /bin/sh -c #(nop) CMD ["bash"] 0 B
82 <missing> 9 weeks ago /bin/sh -c #(nop) ADD file:ebba725fb97cea4... 45.14 MB
83
84
85
86 $ podman history --no-trunc=true --human=false debian
87 ID CREATED CREATED BY SIZE COMMENT
88 b676ca55e4f2c 2017-07-24T16:52:55Z /bin/sh -c #(nop) CMD ["bash"] 0
89 <missing> 2017-07-24T16:52:54Z /bin/sh -c #(nop) ADD file:ebba725fb97cea4... 45142935
90
91
92
93 $ podman history --format "{{.ID}} {{.Created}}" debian
94 b676ca55e4f2c 9 weeks ago
95 <missing> 9 weeks ago
96
97
98
99 $ podman history --format json debian
100 [
101 {
102 "id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
103 "created": "2017-07-24T16:52:55.195062314Z",
104 "createdBy": "/bin/sh -c #(nop) CMD [\"bash\"]",
105 "size": 0,
106 "comment": ""
107 },
108 {
109 "id": "b676ca55e4f2c0ce53d0636438c5372d3efeb5ae99b676fa5a5d1581bad46060",
110 "created": "2017-07-24T16:52:54.898893387Z",
111 "createdBy": "/bin/sh -c #(nop) ADD file:ebba725fb97cea45d0b1b35ccc8144e766fcfc9a78530465c23b0c4674b14042 in / ",
112 "size": 45142935,
113 "comment": ""
114 }
115 ]
116
117
118
120 podman(1)
121
122
124 July 2017, Originally compiled by Urvashi Mohnani umohnani@redhat.com
125 ⟨mailto:umohnani@redhat.com⟩
126
127
128
129 podman-history(1)()