FreeBSD Manual Pages
podman-commit(1) General Commands Manual 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 in- structions can be configured with the --change OPTION and a commit mes- sage 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 com- plete, 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 REPOS- ITORY 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 con- figuration 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/mani- fest/docker_schema2.go#L67. --format, -f=oci | docker Set the format of the image manifest and metadata. The currently sup- ported 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 and podman run 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-run(1), podman-create(1) Troubleshooting See podman-troubleshooting(7) for solutions to common issues. HISTORY December 2017, Originally compiled by Urvashi Mohnani umohnani@red- hat.com <mailto:umohnani@redhat.com> podman-commit(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | HISTORY
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-container-commit&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>