瀏覽代碼

Merge pull request #13987 from larsks/bug/7583

Update docker commit man page re: volumes
Sebastiaan van Stijn 10 年之前
父節點
當前提交
244141a8aa
共有 2 個文件被更改,包括 11 次插入1 次删除
  1. 3 0
      docs/reference/commandline/commit.md
  2. 8 1
      man/docker-commit.1.md

+ 3 - 0
docs/reference/commandline/commit.md

@@ -25,6 +25,9 @@ image. This allows you debug a container by running an interactive shell, or to
 export a working dataset to another server. Generally, it is better to use
 Dockerfiles to manage your images in a documented and maintainable way.
 
+The commit operation will not include any data contained in
+volumes mounted inside the container.
+
 By default, the container being committed and its processes will be paused
 while the image is committed. This reduces the likelihood of encountering data
 corruption during the process of creating the commit.  If this behavior is

+ 8 - 1
man/docker-commit.1.md

@@ -14,7 +14,14 @@ docker-commit - Create a new image from a container's changes
 CONTAINER [REPOSITORY[:TAG]]
 
 # DESCRIPTION
-Using an existing container's name or ID you can create a new image.
+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**=""