1podman-commit(1)()                                          podman-commit(1)()
2
3
4

NAME

6       podman-commit - Create new image based on the changed container
7
8

SYNOPSIS

10       podman commit [options] container image
11
12
13       podman container commit [options] container image
14
15

DESCRIPTION

17       podman commit creates an image based on a changed container. The author
18       of the image can be set using the --author flag. Various image instruc‐
19       tions can be configured with the --change flag and a commit message can
20       be set using the --message flag. The container and  its  processes  are
21       paused  while  the image is committed. This minimizes the likelihood of
22       data corruption when creating the new image. If this  is  not  desired,
23       the --pause flag can be set to false. When the commit is complete, Pod‐
24       man will print out the ID of the new image.
25
26
27       If image does not begin with a registry name component, localhost  will
28       be added to the name.
29
30

OPTIONS

32       --author, -a=author
33
34
35       Set the author for the committed image
36
37
38       --change, -c=instruction
39
40
41       Apply  the  following possible instructions to the created image: CMD |
42       ENTRYPOINT | ENV | EXPOSE | LABEL | ONBUILD | STOPSIGNAL | USER |  VOL‐
43       UME | WORKDIR
44
45
46       Can be set multiple times
47
48
49       --format, -f=format
50
51
52       Set  the format of the image manifest and metadata.  The currently sup‐
53       ported formats are oci  and  docker.   If  not  specifically  set,  the
54       default format used is oci.
55
56
57       --iidfile=ImageIDfile
58
59
60       Write the image ID to the file.
61
62
63       --include-volumes
64
65
66       Include  in  the  committed image any volumes added to the container by
67       the --volume or --mount options to the podman  create  and  podman  run
68       commands.
69
70
71       --message, -m=message
72
73
74       Set  commit message for committed image.  The message field is not sup‐
75       ported in oci format.
76
77
78       --pause, -p
79
80
81       Pause the container when creating an image
82
83
84       --quiet, -q
85
86
87       Suppress output
88
89

EXAMPLES

91              $ podman commit --change CMD=/bin/bash --change ENTRYPOINT=/bin/sh --change LABEL=blue=image reverent_golick image-committed
92              Getting image source signatures
93              Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
94               25.80 MB / 25.80 MB [======================================================] 0s
95              Copying config sha256:c16a6d30f3782288ec4e7521c754acc29d37155629cb39149756f486dae2d4cd
96               448 B / 448 B [============================================================] 0s
97              Writing manifest to image destination
98              Storing signatures
99              e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8
100
101
102
103              $ podman commit -q --message "committing container to image" reverent_golick image-committed
104              e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8
105
106
107
108              $ podman commit -q --author "firstName lastName" reverent_golick image-committed
109              e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8
110
111
112
113              $ podman commit -q --pause=false containerID image-committed
114              e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8
115
116
117

SEE ALSO

119       podman(1), podman-run(1), podman-create(1)
120
121

HISTORY

123       December 2017, Originally compiled  by  Urvashi  Mohnani  umohnani@red‐
124       hat.com ⟨mailto:umohnani@redhat.com⟩
125
126
127
128                                                            podman-commit(1)()