NAME 名称

podman-commit - Create new image based on the changed container
podman-commit - 根据更改的容器创建新镜像

SYNOPSIS 概要

podman commit [options] container [image]
podman commit [选项] 容器 [镜像]

podman container commit [options] container [image]
podman container commit [选项] 容器 [镜像]

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.
podman commit 根据更改的容器创建镜像。可以使用 --author 选项设置镜像的作者。可以使用 --change 选项配置各种镜像指令，并可以使用 --message 选项设置提交消息。在提交镜像时，容器及其进程不会被暂停。如果不希望如此，可以将 --pause 选项设置为 true。提交完成后，Podman 会打印出新镜像的 ID。

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>.
如果 image 不以注册表名称组件开头，则将 localhost 添加到名称中。如果未提供 image ，则创建的镜像的 REPOSITORY 和 TAG 值将设置为 <none> 。

OPTIONS 选项

--author, -a=author --author, -a=author

Set the author for the committed image.
为提交的图像设置作者。

--change, -c=instruction
--change, -c=指令

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.
将容器配置从指定文件合并到镜像的配置中，当镜像被提交时。文件内容应该是 Schema2Config 结构的 JSON 编码版本，该结构在 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.
设置图像清单和元数据的格式。目前支持的格式为 oci 和 docker。
The default is oci.
默认值为 oci。

--iidfile=ImageIDfile

Write the image ID to the file.
将图像 ID 写入文件中。

--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.
将通过 --volume 或 --mount 选项添加到 podman create 和 podman run 命令的容器中的任何卷包含在提交的镜像中。
The default is false.
默认值为 false。

--message, -m=message

Set commit message for committed image.
为提交的图像设置提交消息。
IMPORTANT: The message field is not supported in oci format.
重要提示：消息字段不支持 oci 格式。

--pause, -p

Pause the container when creating an image.
在创建镜像时暂停容器。
The default is false.
默认值为 false。

--quiet, -q

Suppresses output. 抑制输出。
The default is false.
默认值为 false。

--squash, -s

Squash newly built layers into a single new layer.
将新构建的图层压缩成一个新的图层。
The default is false.
默认值为 false。

EXAMPLES 示例

Create image from container with entrypoint and label:
使用 entrypoint 和 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)

HISTORY 历史 ¶

December 2017, Originally compiled by Urvashi Mohnani umohnani@redhat.com
2017 年 12 月，最初由 Urvashi Mohnani umohnani@redhat.com 编写