github.com/justincormack/cli@v0.0.0-20201215022714-831ebeae9675/man/src/container/commit.md (about)

     1  Create a new image from an existing container specified by name or
     2  container ID.  The new image will contain the contents of the
     3  container filesystem, *excluding* any data volumes. Refer to **docker-tag(1)**
     4  for more information about valid image and tag names.
     5  
     6  While the `docker commit` command is a convenient way of extending an
     7  existing image, you should prefer the use of a Dockerfile and `docker
     8  build` for generating images that you intend to share with other
     9  people.
    10  
    11  # EXAMPLES
    12  
    13  ## Creating a new image from an existing container
    14  An existing Fedora based container has had Apache installed while running
    15  in interactive mode with the bash shell. Apache is also running. To
    16  create a new image run `docker ps` to find the container's ID and then run:
    17  
    18      $ docker commit -m="Added Apache to Fedora base image" \
    19        -a="A D Ministrator" 98bd7fc99854 fedora/fedora_httpd:20
    20  
    21  Note that only a-z0-9-_. are allowed when naming images from an 
    22  existing container.
    23  
    24  ## Apply specified Dockerfile instructions while committing the image
    25  If an existing container was created without the DEBUG environment
    26  variable set to "true", you can create a new image based on that
    27  container by first getting the container's ID with `docker ps` and
    28  then running:
    29  
    30      $ docker container commit -c="ENV DEBUG=true" 98bd7fc99854 debug-image