mirror of
https://github.com/containers/podman.git
synced 2025-05-21 09:05:56 +08:00
5389eee737
Generated at build time from troubleshooting.md. Purpose is to ship an actual man page to end users. Much more complicated than initial guess, because there was a bug in my Makefile man page filtering, the sed expression that cleans up markdown that does not translate to roff. All I've done here is reorder some of the expressions, stripping off https links *before* we process podman man page links. Signed-off-by: Ed Santiago <santiago@redhat.com>
135 lines
4.5 KiB
Markdown
135 lines
4.5 KiB
Markdown
% podman-commit 1
|
|
|
|
## NAME
|
|
podman\-commit - Create new image based on the changed container
|
|
|
|
## SYNOPSIS
|
|
**podman commit** [*options*] *container* [*image*]
|
|
|
|
**podman container commit** [*options*] *container* [*image*]
|
|
|
|
## DESCRIPTION
|
|
**podman commit** creates an image based on a changed *container*. The author of the image can be set using the **--author** OPTION. Various image instructions can be configured with the **--change** OPTION and a commit message can be set using the **--message** OPTION. The *container* and its processes aren't paused while the image is committed. If this is not desired, the **--pause** OPTION can be set to *true*. When the commit is complete, Podman prints out the ID of the new image.
|
|
|
|
If `image` does not begin with a registry name component, `localhost` is added to the name.
|
|
If `image` is not provided, the values for the `REPOSITORY` and `TAG` values of the created image is set to `<none>`.
|
|
|
|
## OPTIONS
|
|
#### **--author**, **-a**=*author*
|
|
|
|
Set the author for the committed image.
|
|
|
|
#### **--change**, **-c**=*instruction*
|
|
|
|
Apply the following possible instructions to the created image:
|
|
|
|
- *CMD*
|
|
- *ENTRYPOINT*
|
|
- *ENV*
|
|
- *EXPOSE*
|
|
- *LABEL*
|
|
- *ONBUILD*
|
|
- *STOPSIGNAL*
|
|
- *USER*
|
|
- *VOLUME*
|
|
- *WORKDIR*
|
|
|
|
Can be set multiple times.
|
|
|
|
#### **--config**=*ConfigBlobFile*
|
|
|
|
Merge the container configuration from the specified file into the configuration for the image
|
|
as it is being committed. The file contents should be a JSON-encoded version of
|
|
a Schema2Config structure, which is defined at
|
|
https://github.com/containers/image/blob/v5.29.0/manifest/docker_schema2.go#L67.
|
|
|
|
#### **--format**, **-f**=**oci** | *docker*
|
|
|
|
Set the format of the image manifest and metadata. The currently supported formats are **oci** and *docker*.\
|
|
The default is **oci**.
|
|
|
|
#### **--iidfile**=*ImageIDfile*
|
|
|
|
Write the image ID to the file.
|
|
|
|
#### **--include-volumes**
|
|
|
|
Include in the committed image any volumes added to the container by the **--volume** or **--mount** OPTIONS to the **[podman create](podman-create.1.md)** and **[podman run](podman-run.1.md)** commands.\
|
|
The default is **false**.
|
|
|
|
#### **--message**, **-m**=*message*
|
|
|
|
Set commit message for committed image.\
|
|
*IMPORTANT: The message field is not supported in `oci` format.*
|
|
|
|
#### **--pause**, **-p**
|
|
|
|
Pause the container when creating an image.\
|
|
The default is **false**.
|
|
|
|
#### **--quiet**, **-q**
|
|
|
|
Suppresses output.\
|
|
The default is **false**.
|
|
|
|
#### **--squash**, **-s**
|
|
|
|
Squash newly built layers into a single new layer.\
|
|
The default is **false**.
|
|
|
|
## EXAMPLES
|
|
Create image from container with entrypoint and label:
|
|
```
|
|
$ podman commit --change CMD=/bin/bash --change ENTRYPOINT=/bin/sh --change "LABEL blue=image" reverent_golick image-committed
|
|
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
|
|
e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8
|
|
```
|
|
|
|
Create image from container with commit message:
|
|
```
|
|
$ podman commit -q --message "committing container to image"
|
|
reverent_golick image-committed
|
|
e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8
|
|
```
|
|
|
|
Create image from container with author:
|
|
```
|
|
$ podman commit -q --author "firstName lastName" reverent_golick image-committed
|
|
e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8
|
|
```
|
|
|
|
Pause running container while creating image:
|
|
```
|
|
$ podman commit -q --pause=true containerID image-committed
|
|
e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8
|
|
```
|
|
|
|
Create image from container with default image tag:
|
|
```
|
|
$ podman commit containerID
|
|
e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8
|
|
```
|
|
|
|
Create image from container with default required capabilities:
|
|
```
|
|
$ podman commit -q --change LABEL=io.containers.capabilities=setuid,setgid epic_nobel privimage
|
|
400d31a3f36dca751435e80a0e16da4859beb51ff84670ce6bdc5edb30b94066
|
|
```
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-run(1)](podman-run.1.md)**, **[podman-create(1)](podman-create.1.md)**
|
|
|
|
### Troubleshooting
|
|
|
|
See [podman-troubleshooting(7)](https://github.com/containers/podman/blob/main/troubleshooting.md)
|
|
for solutions to common issues.
|
|
|
|
## HISTORY
|
|
December 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>
|