MAN page from RedHat EL 7 docker-cli-19.03.11.ol-11.el7.x86_64.rpm

DOCKER

Section: (1)
Updated: Jun 2021
Index

NAME

docker-container-commit - Create a new image from a container's changes

SYNOPSIS

docker container commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]]

DESCRIPTION

Create a new image from an existing container specified by name orcontainer ID. The new image will contain the contents of thecontainer filesystem, excluding any data volumes. Refer to docker-tag(1)for more information about valid image and tag names.

While the docker commit command is a convenient way of extending anexisting image, you should prefer the use of a Dockerfile and dockerbuild for generating images that you intend to share with otherpeople.

EXAMPLES

Creating a new image from an existing container

An existing Fedora based container has had Apache installed while runningin interactive mode with the bash shell. Apache is also running. Tocreate a new image run docker ps to find the container's ID and then run:

$ docker commit -m="Added Apache to Fedora base image" \  -a="A D Ministrator" 98bd7fc99854 fedora/fedora_httpd:20

Note that only a-z0-9-_. are allowed when naming images from anexisting container.

Apply specified Dockerfile instructions while committing the image

If an existing container was created without the DEBUG environmentvariable set to "true", you can create a new image based on thatcontainer by first getting the container's ID with docker ps andthen running:

$ docker container commit -c="ENV DEBUG true" 98bd7fc99854 debug-image

OPTIONS

-a, --author=""
Author (e.g., "John Hannibal Smith <hannibalAATTa-team.com>")

-c, --change=
Apply Dockerfile instruction to the created image

-h, --help[=false]
help for commit

-m, --message=""
Commit message

-p, --pause[=true]
Pause container during commit

Index

NAME
SYNOPSIS
DESCRIPTION
EXAMPLES
Creating a new image from an existing container
Apply specified Dockerfile instructions while committing the image
OPTIONS
SEE ALSO

This document was created byman2html,using the manual pages.