mirror of
https://github.com/containers/podman.git
synced 2025-05-19 16:18:51 +08:00
6065f18da6
Signed-off-by: Daniel J Walsh <dwalsh@redhat.com> Closes: #159 Approved by: TomSweeneyRedHat
97 lines
3.5 KiB
Markdown
97 lines
3.5 KiB
Markdown
% podman(1) podman-commit - Tool to create new image based on the changed container
|
|
% Urvashi Mohnani
|
|
# podman-commit "1" "December 2017" "podman"
|
|
|
|
## NAME
|
|
podman commit - Create new image based on the changed container
|
|
|
|
## SYNOPSIS
|
|
**podman commit**
|
|
**TARBALL**
|
|
[**--author**|**-a**]
|
|
[**--change**|**-c**]
|
|
[**--message**|**-m**]
|
|
[**--help**|**-h**]
|
|
|
|
## DESCRIPTION
|
|
**podman commit** creates an image based on a changed container. The author of the
|
|
image can be set using the **--author** flag. Various image instructions can be
|
|
configured with the **--change** flag and a commit message can be set using the
|
|
**--message** flag. The container and its processes are paused while the image is
|
|
committed. This minimizes the likelihood of data corruption when creating the new
|
|
image. If this is not desired, the **--pause** flag can be set to false.
|
|
|
|
**podman [GLOBAL OPTIONS]**
|
|
|
|
**podman commit [GLOBAL OPTIONS]**
|
|
|
|
**podman commit [OPTIONS] CONTAINER**
|
|
|
|
## OPTIONS
|
|
|
|
**--author, -a**
|
|
Set the author for the committed image
|
|
|
|
**--change, -c**
|
|
Apply the following possible instructions to the created image:
|
|
**CMD** | **ENTRYPOINT** | **ENV** | **EXPOSE** | **LABEL** | **STOPSIGNAL** | **USER** | **VOLUME** | **WORKDIR**
|
|
Can be set multiple times
|
|
|
|
**--message, -m**
|
|
Set commit message for committed image
|
|
|
|
**--pause, -p**
|
|
Pause the container when creating an image
|
|
|
|
## EXAMPLES
|
|
|
|
```
|
|
# podman commit --change CMD=/bin/bash --change ENTRYPOINT=/bin/sh --change LABEL=blue=image reverent_golick image-commited
|
|
Getting image source signatures
|
|
Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
|
|
25.80 MB / 25.80 MB [======================================================] 0s
|
|
Copying config sha256:c16a6d30f3782288ec4e7521c754acc29d37155629cb39149756f486dae2d4cd
|
|
448 B / 448 B [============================================================] 0s
|
|
Writing manifest to image destination
|
|
Storing signatures
|
|
```
|
|
|
|
```
|
|
# podman commit --message "commiting container to image" reverent_golick image-commited
|
|
Getting image source signatures
|
|
Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
|
|
25.80 MB / 25.80 MB [======================================================] 0s
|
|
Copying config sha256:af376cdda5c0ac1d9592bf56567253d203f8de6a8edf356c683a645d75221540
|
|
376 B / 376 B [============================================================] 0s
|
|
Writing manifest to image destination
|
|
Storing signatures
|
|
```
|
|
|
|
```
|
|
# podman commit --author "firstName lastName" reverent_golick
|
|
Getting image source signatures
|
|
Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
|
|
25.80 MB / 25.80 MB [======================================================] 0s
|
|
Copying config sha256:d61387b4d5edf65edee5353e2340783703074ffeaaac529cde97a8357eea7645
|
|
378 B / 378 B [============================================================] 0s
|
|
Writing manifest to image destination
|
|
Storing signatures
|
|
```
|
|
|
|
```
|
|
# podman commit --pause=false reverent_golick image-commited
|
|
Getting image source signatures
|
|
Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
|
|
25.80 MB / 25.80 MB [======================================================] 0s
|
|
Copying config sha256:5813fe8a3b18696089fd09957a12e88bda43dc1745b5240879ffffe93240d29a
|
|
419 B / 419 B [============================================================] 0s
|
|
Writing manifest to image destination
|
|
Storing signatures
|
|
```
|
|
|
|
## SEE ALSO
|
|
podman(1), podman-run(1), podman-create(1)
|
|
|
|
## HISTORY
|
|
December 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>
|