docker volumes docs out of date #20465

Open
cpuguy83 opened this Issue Feb 18, 2016 · 4 comments

Projects

None yet

5 participants

@cpuguy83
Contributor

The documentation for docker volumes (found here: https://docs.docker.com/engine/userguide/containers/dockervolumes/) is woefully out of date.

Since docker 1.9 includes top-level volume subcommands, and support for volume plugins, this documentation should be updated to reflect these new features.
It should also de-emphasize data-only containers as these are no longer considered a recommended pattern.

@cpuguy83 cpuguy83 added the kind/docs label Feb 18, 2016
@AriaFallah

In the mean time, where can I learn about the docker volume command and how to use it?

@mabraham

@AriaFallah https://docs.docker.com/engine/tutorials/dockervolumes/ does document at least some of the functionality of docker volume

@EugenMayer

At least this section needs to be updated i guess https://docs.docker.com/engine/tutorials/dockervolumes/#/creating-and-mounting-a-data-volume-container ... please notice that this already leads to issues / misconceptions like http://stackoverflow.com/questions/39013222/data-container-with-named-or-anonymous-volumes-conceptual-problems-discuss .. it would be great to get this fixed

@jwhitlock jwhitlock added a commit to mozilla/kuma that referenced this issue Sep 23, 2016
@jwhitlock jwhitlock bug 1218563: Use named volume for mysql container
Instead of a data container, create and use a named volume to store the
MySQL database.  The Docker community suggests this method, but the
Docker docs still suggest data-only containers.

http://stackoverflow.com/a/20652410/10612
docker/docker#20465
ec98860
@jwhitlock jwhitlock added a commit to mozilla/kuma that referenced this issue Sep 24, 2016
@jwhitlock jwhitlock bug 1218563: Use named volume for mysql container
Instead of a data container, create and use a named volume to store the
MySQL database.  The Docker community suggests this method, but the
Docker docs still suggest data-only containers.

http://stackoverflow.com/a/20652410/10612
docker/docker#20465
0de5c00
@chernals
chernals commented Oct 1, 2016

Reviving this issue as I believe the present doc is quite misleading. It took me a while to understand the present-day situation.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment