mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00

Doug Davis 0bf0e5a6ef Align 'docker commit' docs with the code

It was missing some variants and 'maintainer' isn't actually supported.
Also sorted the list of allowed cmds in the code just to make it easier
to diff with the docs.

Signed-off-by: Doug Davis <dug@us.ibm.com>

2015-07-09 13:17:47 -07:00

2.3 KiB

Raw Blame History

% DOCKER(1) Docker User Manuals % Docker Community % JUNE 2014

NAME

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

SYNOPSIS

docker commit [-a|--author[=AUTHOR]] [--help] [-c|--change[= []]] [-m**|--message[=MESSAGE]] [-p|--pause[=true]] CONTAINER [REPOSITORY[:TAG]]

DESCRIPTION

Create a new image from an existing container specified by name or container ID. The new image will contain the contents of the container filesystem, excluding any data volumes.

While the docker commit command is a convenient way of extending an existing image, you should prefer the use of a Dockerfile and docker build for generating images that you intend to share with other people.

OPTIONS

-a, --author="" Author (e.g., "John Hannibal Smith hannibal@a-team.com")

--help Print usage statement

-m, --message="" Commit message

-p, --pause=true|false Pause container during commit. The default is true.

EXAMPLES

Creating a new image from an existing container

An existing Fedora based container has had Apache installed while running in interactive mode with the bash shell. Apache is also running. To create 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

Apply specified Dockerfile instructions while committing the image

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

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

HISTORY

April 2014, Originally compiled by William Henry (whenry at redhat dot com) based on docker.com source material and in June 2014, updated by Sven Dowideit SvenDowideit@home.org.au July 2014, updated by Sven Dowideit SvenDowideit@home.org.au Oct 2014, updated by Daniel, Dao Quang Minh

2.3 KiB Raw Blame History