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