kotovalexarian-likes-github
/
moby--moby
mirror of https://github.com/moby/moby.git
1
0
Fork 0
Code Releases Activity

Merge pull request #19051 from thaJeztah/dont-touch-var-lib-volumes 

docs: add note to volume-plugins
This commit is contained in:
moxiegirl 2016-01-05 09:15:21 -08:00
parent b2d00e312b fb893cf656
commit f67fed5f77
1 changed files with 7 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
docs/extend/plugins_volume.md
View File

@ -15,7 +15,7 @@ storage systems, such as Amazon EBS, and enable data volumes to persist beyond
the lifetime of a single Docker host. See the [plugin documentation](plugins.md) the lifetime of a single Docker host. See the [plugin documentation](plugins.md)
for more information. for more information.
# Command-line changes ## Command-line changes
A volume plugin makes use of the `-v`and `--volume-driver` flag on the `docker run` command. The `-v` flag accepts a volume name and the `--volume-driver` flag a driver type, for example: A volume plugin makes use of the `-v`and `--volume-driver` flag on the `docker run` command. The `-v` flag accepts a volume name and the `--volume-driver` flag a driver type, for example:
@ -32,13 +32,13 @@ server to another.
By specifying a `volumedriver` in conjunction with a `volumename`, users can use plugins such as [Flocker](https://clusterhq.com/docker-plugin/) to manage volumes external to a single host, such as those on EBS. By specifying a `volumedriver` in conjunction with a `volumename`, users can use plugins such as [Flocker](https://clusterhq.com/docker-plugin/) to manage volumes external to a single host, such as those on EBS.
# Create a VolumeDriver ## Create a VolumeDriver
The container creation endpoint (`/containers/create`) accepts a `VolumeDriver` The container creation endpoint (`/containers/create`) accepts a `VolumeDriver`
field of type `string` allowing to specify the name of the driver. It's default field of type `string` allowing to specify the name of the driver. It's default
value of `"local"` (the default driver for local volumes). value of `"local"` (the default driver for local volumes).
# Volume plugin protocol ## Volume plugin protocol
If a plugin registers itself as a `VolumeDriver` when activated, then it is If a plugin registers itself as a `VolumeDriver` when activated, then it is
expected to provide writeable paths on the host filesystem for the Docker expected to provide writeable paths on the host filesystem for the Docker
@ -47,6 +47,10 @@ daemon to provide to containers to consume.
The Docker daemon handles bind-mounting the provided paths into user The Docker daemon handles bind-mounting the provided paths into user
containers. containers.
> **Note**: Volume plugins should *not* write data to the `/var/lib/docker/`
> directory, including `/var/lib/docker/volumes`. The `/var/lib/docker/`
> directory is reserved for Docker.
### /VolumeDriver.Create ### /VolumeDriver.Create
**Request**: **Request**: