kotovalexarian-likes-github/moby--moby
1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00
Code Releases Activity
moby--moby/docs/sources/experimental/plugins_volume.md
Mary Anthony 1ba1a0550f Fixes title, line wrap, and Adds install area 
Tibor's comment
Updating with the new plugins
Entering comments from Seb

Signed-off-by: Mary Anthony <mary@docker.com>
2015-05-26 15:37:38 -07:00

2 KiB
Raw Blame History

page_title: Experimental feature - Volume plugins page_keywords: experimental, Docker, plugins, volume

Experimental: Docker volume plugins

Docker volume plugins enable Docker deployments to be integrated with external storage systems, such as Amazon EBS, and enable data volumes to persist beyond the lifetime of a single Docker host. See the plugin documentation for more information.

This is an experimental feature. For information on installing and using experimental features, see the experimental feature overview.

Command-line changes

This experimental features introduces two changes to the docker run command:

  • The --volume-driver flag is introduced.
  • The -v syntax is changed to accept a volume name a first component.

Example:

$ docker run -ti -v volumename:/data --volume-driver=flocker busybox sh

By specifying a volume name in conjunction with a volume driver, volume plugins such as Flocker, once installed, can be used to manage volumes external to a single host, such as those on EBS. In this example, "volumename" is passed through to the volume plugin as a user-given name for the volume which allows the plugin to associate it with an external volume beyond the lifetime of a single container or container host. This can be used, for example, to move a stateful container from one server to another.

The volumename must not begin with a /.

API changes

The container creation endpoint (/containers/create) accepts a VolumeDriver field of type string allowing to specify the name of the driver. It's default value of "local" (the default driver for local volumes).

Related GitHub PRs and issues

  • #13161 Volume refactor and external volume plugins

Send us feedback and comments on #13420, or on the usual Google Groups (docker-user, docker-dev) and IRC channels.