podman-container-commit

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 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 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